Critty CLI

Critty opens a terminal interface where a person comments on a diff, answers questions and approves agent actions.

  • 105 ★ on the repository
  • Last commit
  • MIT
CLI

Minimal access

Why this level

  • The tool shows diffs and passes the person's answers to the agent; it does not change repository files itself.
All reasons and checks

crittylabs/critty

Install

Manual install

mise install github:crittylabs/critty

The first Install command from the README. Then `critty doctor` and `critty install --user <agent>`.

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The tool shows diffs and passes the person's answers to the agent; it does not change repository files itself.

This is third-party code. Review the repository files before installing.

What it does

Critty turns an agent request into a terminal review. The agent prepares a diff, file or document, Critty opens it in a pane next to the chat, the person comments on lines, answers questions, confirms details or approves actions, and the answers go back to the agent. You can agree in advance which actions need approval, such as pushing code or deploying. Next to a chat in tmux, Herdr or cmux the review opens in a pane or tab; without a multiplexer a terminal emulator window launches. While a review waits, Critty tells the terminal through the Program Status Protocol (OSC 7501). Skills are installed with `critty install`, with variants for Claude Code, Codex, OpenCode, Antigravity CLI and Gemini CLI.

Who it is for. Developers who chat with an agent in a terminal and want to review its edits line by line without leaving the session.

Good fit when

  • An agent finished an edit and the diff needs line comments.
  • A push or deploy requires explicit approval from a person.
  • The agent needs a choice among several options with an explanation.
  • A document or plan should be refined with the agent through margin notes.

Not a fit when

  • Work happens in a web interface without a terminal.
  • The agent runs unattended and would never receive an answer.
  • Only automated checks are wanted, with no human in the loop.

Example request

Open my branch diff in Critty, let me leave line comments and ask for approval through `critty-approval` before pushing.

Limitations

Git 2.31.0 or newer is needed for repository reviews; building from source requires Go 1.27.2. Release binaries ship for macOS and Linux on amd64 and arm64. Floating tmux panes need tmux 3.8, older versions use splits. Terminal emulator windows do not open over SSH, so a multiplexer is required. `critty doctor` checks the environment, agent integrations and review launchers, and after an upgrade rerun the skill install with `--force`.

How to disable. Delete the agent skills from its directory (`critty install` places them in the user or project folder), then remove the `critty` binary and `~/.config/critty/config.toml`.

FAQ

How do I install it?

Run `mise install github:crittylabs/critty`. Alternative: `go install github.com/crittylabs/critty/cmd/critty@latest`.

How do I connect it to Claude Code?

Run `critty install --user claude-code`, then start a review with `/critty`.

What does critty doctor do?

It checks installed agent integrations, review launchers, image settings and prerequisites for optional AI reviews.

Which agents are supported?

Claude Code, Codex, OpenCode, Antigravity CLI (target `agy`) and Gemini CLI.

Where are the settings?

In `~/.config/critty/config.toml` and the project `.critty.toml`; older JSON settings convert on startup.

Discussion

No questions or reviews yet.

CLI tools

Crit opens a coding agent's plans, diffs and running apps in a browser: click a line, leave a comment and the agent receives it

CLIExtended access1.3KRepository stars

A TUI that shows what Claude Code, Codex, Gemini CLI and opencode do in a project: the open file, last-commit diff, live commands

CLIMinimal access76Repository stars

One desktop window for Claude Code, Codex, Gemini CLI and OpenCode: terminals, pull requests, diffs and approvals

CLIBroad access348Repository stars

A CLI opens diffs and documents in a terminal so a person can annotate lines and pass feedback to a coding agent

CLIExtended access956Repository stars

The tuicr skill links an agent to terminal code review: it reads the human's comments and opens the review pane.

SkillExtended access3.6KRepository stars

A macOS terminal with the termio CLI and a skill: agents spawn sibling sessions and you see which one needs your answer

CLIBroad access790Repository stars

README in short

Critty installs as one binary plus agent skills; a review opens in a multiplexer pane next to the chat.

README badge

Report a problem