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.