Skip to main content
The Kodus CLI reviews your code changes directly from the terminal — catching bugs, security issues, and style violations before they reach a pull request.

​
Getting Started

1

Install

Requires Node.js >= 18.0.0.
2

Authenticate

You can start without an account — just run kodus review. For full access, pick one:
kodus auth login
Self-hosted? Point the CLI to your own API:
export KODUS_API_URL=https://kodus-api.yourcompany.com
HTTPS required (except localhost).
3

Run Your First Review

kodus review
That’s it. The CLI will analyze your working tree changes and show issues interactively. You can also:
kodus review --staged       # Only staged files
kodus review --branch main  # Compare against a branch
kodus review --fix          # Auto-apply all fixes

​
What You Can Do

Interactive Review

Browse files, preview fixes, and apply them one by one from your terminal.

Auto-fix

Apply all fixable issues at once with --fix.

AI Agent Integration

Use --prompt-only to feed structured output to Claude Code, Cursor, or Windsurf for automated fix loops.

Pre-push Hooks

Block pushes with issues above a severity threshold.

Decision Memory

Capture AI agent decisions as structured files in your repo.

PR Suggestions

Fetch Kody’s suggestions for open pull requests directly from the terminal.

​
Limits

Trial (No Account)Authenticated
Reviews per day5Based on your plan
Files per review10100
Lines per file500—
Max diff size per file500 KB500 KB
Max content size per file2 MB2 MB
Trial limits reset daily. Run kodus auth status to check your current usage.

​
Environment Variables

VariableDescription
KODUS_API_URLAPI endpoint (default: https://api.kodus.io)
KODUS_TEAM_KEYTeam key for shared access and AI agents
KODUS_VERBOSESet to true for verbose output
KODUS_SKIP_HOOKSet to 1 to skip the pre-push hook

​
Next Steps

Command Reference

All commands, flags, and options.

AI Agents

Set up autonomous review-fix loops with coding agents.