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
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.
Install
- Works in
Manual install
mise install github:crittylabs/crittyThe first Install command from the README. Then `critty doctor` and `critty install --user <agent>`.
Access and checks
How we reviewMinimal 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.
Related
CLI toolsCrit opens a coding agent's plans, diffs and running apps in a browser: click a line, leave a comment and the agent receives it
A TUI that shows what Claude Code, Codex, Gemini CLI and opencode do in a project: the open file, last-commit diff, live commands
One desktop window for Claude Code, Codex, Gemini CLI and OpenCode: terminals, pull requests, diffs and approvals
A CLI opens diffs and documents in a terminal so a person can annotate lines and pass feedback to a coding agent
The tuicr skill links an agent to terminal code review: it reads the human's comments and opens the review pane.
A macOS terminal with the termio CLI and a skill: agents spawn sibling sessions and you see which one needs your answer
README in short
Critty installs as one binary plus agent skills; a review opens in a multiplexer pane next to the chat.