Skip to content

autocorrect

Correct grammar and spelling in text using a local or remote LLM.

Usage

agent-cli autocorrect [TEXT]

Description

This is a simple, one-shot command that:

  1. Reads text from your system clipboard (or from a direct argument)
  2. Sends the text to an LLM with a prompt to perform only technical corrections
  3. Copies the corrected text back to your clipboard, replacing the original

This tool is ideal for integrating with a system-wide hotkey.

Examples

# Correct text from clipboard
agent-cli autocorrect

# Correct text from argument
agent-cli autocorrect "this text has an eror"

Options

Provider Selection

Option Default Description
--llm-provider ollama The LLM provider to use ('ollama', 'openai', 'gemini').

LLM: Ollama

Option Default Description
--llm-ollama-model gemma3:4b The Ollama model to use. Default is gemma3:4b.
--llm-ollama-host http://localhost:11434 The Ollama server host. Default is http://localhost:11434.

LLM: OpenAI-compatible

Option Default Description
--llm-openai-model gpt-5-mini The OpenAI model to use for LLM tasks.
--openai-api-key - Your OpenAI API key. Can also be set with the OPENAI_API_KEY environment variable.
--openai-base-url - Custom base URL for OpenAI-compatible API (e.g., for llama-server: http://localhost:8080/v1).

LLM: Gemini

Option Default Description
--llm-gemini-model gemini-3-flash-preview The Gemini model to use for LLM tasks.
--gemini-api-key - Your Gemini API key. Can also be set with the GEMINI_API_KEY environment variable.

General Options

Option Default Description
--log-level warning Set logging level.
--log-file - Path to a file to write logs to.
--quiet, -q false Suppress console output from rich.
--json false Output result as JSON (implies --quiet and --no-clipboard).
--config - Path to a TOML configuration file.
--print-args false Print the command line arguments, including variables taken from the configuration file.

Workflow Integration

System-Wide Hotkey

Set up a hotkey to run autocorrect on your clipboard:

cmd + shift + a : /path/to/agent-cli autocorrect

bind = SUPER SHIFT, A, exec, agent-cli autocorrect

Typical Usage

  1. Select and copy text with errors
  2. Press your hotkey (e.g., Cmd+Shift+A)
  3. Paste the corrected text