Polygloss

Polygloss is a local code review app for macOS. Open any diff (your working tree, a commit, or a branch compared like a pull request) and review it the way you would on GitHub: mark files Viewed, leave threaded comments, then submit the review. Your coding agent reads it over MCP and gets back to work.

Your code never leaves your machine. There are no accounts and no server, and the only network access is an optional update check.

Why?

Agents change a lot of code quickly. Reading those changes in a terminal is painful, and pushing to GitHub just to read a diff is slow. Polygloss brings GitHub's review flow to your own machine and closes the loop with the agent: when you submit a review, Claude Code wakes up, reads your comments, fixes the code, and asks you to look again.

Related MCP server: codex-code-review

Installation

Download Polygloss_<version>_aarch64.dmg from the latest release, open it and drag Polygloss to Applications, then run "Install CLI" from ⌘K. You need macOS 14 or later on Apple Silicon and git 2.39 or later. Releases are signed and notarized, and update in place.

Or build from source with rustup, Bun 1.3 and cargo-packager 0.11.8 (details):

git clone https://github.com/dakdevs/polygloss && cd polygloss
bun install --frozen-lockfile
scripts/package-release.sh   # builds dist/Polygloss.app
open dist/Polygloss.app      # then run "Install CLI" from ⌘K

To connect Claude Code, install the plugin. It adds the MCP server and the hook that wakes Claude when you submit:

claude plugin marketplace add dakdevs/polygloss
claude plugin install polygloss@polygloss

Other agents can run polygloss mcp as a stdio MCP server or use the JSON CLI (docs/agents.md).

Usage

polygloss                       # working tree against its merge-base
polygloss show HEAD             # one commit
polygloss compare main feature  # a branch, like a pull request

Or ask Claude to "open this in Polygloss for review". In the app, ⌘K lists every action and ? every key.

Some notes

Polygloss is early. It works end to end, but expect rough edges.

Documentation

• User guide: reviewing, comments, Viewed, live mode, keys, settings, themes

• Agents: the Claude Code plugin, MCP tools, the JSON CLI

• Design and decision records

Development

Read CONTRIBUTING.md first. Run cargo only through scripts/cargo.sh, because a Homebrew cargo earlier on PATH breaks the build. Before sending a change, run:

bun install --frozen-lockfile
bun run format
bun run lint
bun run test:unit
bun test
bun run test:e2e

License

MIT OR Apache-2.0, at your option. See NOTICE for third-party credits.