Catty Coding Agent

Catty is a terminal code review agent for teams. It focuses on reviewing code for correctness, security, reliability, maintainability, performance, API regressions, data loss risks, race conditions, and meaningful missing tests.

Install

npm install -g catty-coding-agent
catty

Built-in review skill

Catty ships with a default catty-code-review skill. It is loaded automatically, so users do not need to install a separate code-review skill.

In the TUI you can invoke it explicitly with:

/skill:catty-code-review

Review-first behavior

Catty defaults to review-only tools:

read, bash, grep, find, ls

It does not edit files by default. If you explicitly want implementation help, opt in to mutation tools:

catty --tools read,bash,edit,write

Common usage

catty "Review this repository for correctness and security issues"
catty -p "Review src/ for regressions"
catty --tools read,grep,find,ls,bash -p "Review this diff"

Team PR reviews through your org provider

Catty can authenticate to your shared CattyBug provider and request a GitHub PR review in one command:

catty review your-org/repo#123 --provider https://cattybug.your-org.com

If you are not logged in, Catty opens GitHub login, verifies your org through the provider, stores a local provider token, and then continues the review request.

Useful commands:

catty login --provider https://cattybug.your-org.com
catty review your-org/repo#123 --effort deep
catty status
catty logout

For solo/local model usage, store an OpenRouter key:

catty auth openrouter sk-or-v1-...

Configuration

Catty stores local settings and sessions under:

~/.catty/agent

Useful environment variables:

CATTY_CODING_AGENT_DIR
CATTY_CODING_AGENT_SESSION_DIR
CATTY_PACKAGE_DIR
CATTY_OFFLINE
CATTY_TELEMETRY
CATTY_SHARE_VIEWER_URL

Provider API keys follow the provider names shown in catty --help.