Clipboard in, clipboard out · pipe-friendly · commit messages · PR descriptions

Polish AI text polishing from your terminal

Fix grammar and tone in the terminal. Sign in with ChatGPT or Claude — then run polish on your clipboard, pipes, or git diffs.

macOS · Linux ChatGPT · Claude Clipboard -c Commits · --pr
brew tap aresgott/polish brew install polish
curl -fsSL https://raw.githubusercontent.com/aresgott/polish/main/packaging/linux/install.sh | bash

Installs Node.js (apt, Homebrew, or nvm), @aresgott/polish, and xclip if needed.

polish — zsh Clipboard

What it does

Grammar, tone, commit messages, and PR descriptions — without leaving the terminal.

Run polish with no arguments to polish whatever is on your clipboard — the result lands on your clipboard again. Add inline text, pipes, tone flags, or git modes when you need more control.

Polish prose

Fix spelling and grammar while keeping your meaning, apostrophes, and emojis.

-f

Tone & config

Pick a tone per run (-f, -o, -s, -poetic, …) or set a default with polish config official — stored in ~/.polish/config.json.

|

Pipe text in

Stream files and drafts through Polish — cat notes.txt | polish prints to stdout.

-c

Commit messages & PR descriptions

Creates commit messages from staged or piped diffs (polish -c) and full PR descriptions from branch changes (polish --pr) — ready to paste or pipe into git.

⌘C

Just run polish

polish reads your clipboard (or lets you paste if empty), polishes the text, and copies the result back. Use -np when you only want stdout.

Sign in

polish login — ChatGPT or Claude.

Default tone is friendly. Also: -o official, -s scientific, -political, -poetic. Set a default with polish config official.

Everyday use

Clipboard, tone, pipes, and git.

Copy text, run polish, paste the result. Pass arguments for inline polish, tone flags for one-off style, or polish config to save your default tone.

$polish login
$polish
$polish thanks for the quik update
$polish -f thanks team
$polish config official
$cat notes.txt | polish
$git diff --staged | polish -c
$polish --pr

Install once. Polish everywhere.

Run polish login, then polish clipboard, pipes, or git — all from the terminal.