Writing Tools

Private, local AI-assisted writing tools for the COSMIC™ desktop.

Features

Writing Tools offers Apple-style writing actions, rewrite, proofread, summarize, and tone adjustments, powered by a model running on your own machine. Your text is never sent to a cloud service.

• Rewrite text while keeping its meaning.
• Proofread for spelling, grammar, and punctuation.
• Summarize long passages into something short.
• Adjust the tone of your writing to fit the occasion.
• Fully local. Works with Ollama and LM Studio, so nothing leaves your computer.
• Built with libcosmic to match the rest of the COSMIC desktop.

Local model setup

Writing Tools talks to a model server running on your machine. Select the provider under Local Model, then set its endpoint and the identifier of the loaded model.

Ollama

Install Ollama, then download and start a model:

ollama run llama3.2

The default endpoint is http://127.0.0.1:11434 and the default model is llama3.2.

LM Studio

Load a model in LM Studio and start its local server. Then, in Writing Tools:

1. Select LM Studio as the provider.
2. Set the endpoint to the server address, normally http://127.0.0.1:1234.
3. Enter the identifier of the loaded model.

Writing Tools sends native LM Studio requests to /api/v1/chat.

Installation

A justfile is included for the casey/just command runner.

git clone https://github.com/cosmic-utils/cosmic-ext-writing-tools.git
cd cosmic-ext-writing-tools
sudo just install

Command	Description
just	Builds the application (default just build-release recipe)
just run	Builds and runs the application
just install	Installs the project into the system
just vendor	Creates a vendored tarball
just build-vendored	Compiles with vendored dependencies from that tarball
just check	Runs clippy to check for linter warnings
just check-json	Same as check, for IDEs that support LSP

Build

git clone https://github.com/cosmic-utils/cosmic-ext-writing-tools.git
cd cosmic-ext-writing-tools
cargo build

Dependencies

• libcosmic
• Ollama or LM Studio at runtime

Packaging

If packaging for a Linux distribution, vendor dependencies locally with the vendor rule, and build with the vendored sources using the build-vendored rule. When installing files, use the rootdir and prefix variables to change installation paths.

just vendor
just build-vendored
just rootdir=debian/cosmic_ext_writing_tools prefix=/usr install

It is recommended to build a source tarball with the vendored dependencies, which can typically be done by running just vendor on the host system before it enters the build environment.

Translators

Fluent is used for localization of the software. Fluent's translation files are found in the i18n directory. To add a new translation, copy the English (en) localization, rename en to the desired ISO 639-1 language code, and provide a translation for each message identifier. If no translation is necessary, the message may be omitted.

Copyright and licensing

Copyright 2026 © Eduardo Flores

Writing Tools is released under the terms of the GPL-3.0.