Parlance
MAC · CLI

Read and write the language of coding agents.

Claude Code and Codex talk in dense, jargon-heavy English. Parlance turns what they say into plain language you can follow, and turns what you mean, typed in any language, into a natural English prompt pasted back into the input.

Bring your own key for Gemini, DeepSeek, OpenAI or Claude, or any OpenAI-compatible service such as a local Ollama. There is no Parlance server.

2shortcuts, write and explain, in any app
0Parlance servers and no telemetry. Text goes only to the API you set up
1open-source core. The CLI and the app share the same prompts and term checks
HOW IT WORKS

In the app you are using,press one shortcut.

  1. 1

    Type in an input, or select a passage

    Claude Code in a terminal, the Codex desktop app, or any text field. Chinese, English or a mix.

  2. 2

    Press the shortcut

    Write is ⌃⌥⌘ Space, explain is ⌃⌥⌘ E. The panel opens where you are, without switching apps.

  3. 3

    Press ↵ to paste it back

    The best version goes into the input you came from. Parlance never presses Return for you.

01 · WRITE

A natural version,with a translation back.

The best version comes first, with a translation into your language underneath so you can check the meaning held. Two alternatives each note how they differ. Switch tone between an instruction for an agent and everyday writing.

  • When you already wrote English, it points out what sounds off, and why.
  • ⇥ moves between versions, and ⌘1 to ⌘3 picks one.
  • Reopening restores your last input and results, so a stray Esc loses nothing.
02 · EXPLAIN

Translation, plain words,jargon cards.

Select the part of the agent output you could not follow. Parlance reads the text around it as context, then gives a translation, a one-line plain version, and what each term means in that passage.

  • Press ⌘1 for related vocabulary, ⌘2 for background, or ask a follow-up.
  • When an app does not expose its text, you can turn on window capture. Recognition runs on your Mac and the image never leaves it.
03 · CODE STAYS CODE

Identifiers, paths and flagscome through as written.

camelCase, snake_case, dotted calls, file paths, --flags, URLs and anything in backticks are swapped for placeholders before sending, then counted and restored. A version that fails the check is marked, and you cannot paste or copy it.

04 · CLI, FREE AND OPEN SOURCE

Same thing in the terminal,with pl.

herdr panes, SSH and tmux have no floating panel, so use pl. Same core, same prompts. Keep the key in the Keychain, an environment variable, or your password manager. --json is there for scripts.

GPL-3.0-or-later · Swift 6 · the Homebrew build needs macOS 15.6 or later

$ brew install zjlgdx/tap/parlance
$ pl auth set --provider gemini # stored in the Keychain, no echo
$ pl fix "帮我把这个函数拆开,太长了"
Split this function up; it's too long.
把这个函数拆开;它太长了。
$ pbpaste | pl explain --context notes.md -
PRIVACY

Only the text you submit,and you can see what was sent.

No Parlance server

Text goes only to the API you set up. No account, no telemetry, no cloud sync.

Context is redacted first

Before anything leaves your Mac, text that looks like an API key, token or private key becomes [REDACTED]. Rules can miss rare formats, so ⌘I in the panel always shows what is being sent.

The clipboard is borrowed, then restored

Pasting and capturing use the clipboard briefly, then put back everything other apps can read. A format an app keeps only to itself may not come back. You can turn this off in settings.

Parlance for Mac is in progress

The Mac app will be a one-time purchase, priced at release. The CLI works today: one command to install, free and open source.

View the sourceGitHub · CLI and ParlanceCore

Accessibility permission is needed to read selections and paste. Screen recording is optional, used only when an app does not expose its text. Before the first paste, macOS may ask whether to allow reading the clipboard. Choose Allow.