Quick Start
Go from zero to a landed change in 5 minutes
This page is a condensed end-to-end walkthrough. If you want detailed explanations, see the individual pages in the Getting Started section. This is the fast path.
Install
npm install -g @mandipadk7/kaviVerify Prerequisites
kavi doctorYou need Node.js (v18+), git, Claude CLI (authenticated), and Codex CLI. If anything is missing, kavi doctor tells you what to fix.
Initialize Your Project
cd your-project
kavi initThis creates .kavi/config.toml and the .kavi/state/ directory.
Optionally, create user-level defaults that apply across all repos:
kavi init --homeCompose a Task
Type a task description and submit it:
Refactor the database connection pool to use async initializationKavi routes the task to the best agent (Claude or Codex) based on your routing rules and AI classification. You can override the choice if you prefer a different agent.
Approve and Watch
As the agent works:
- Approve tool calls as they appear in the approval gateway. Each file read, write, or command execution requires your explicit approval.
- Watch execution in real time. Switch views to see the agent's streaming output.
Review
When the agent finishes, inspect the result in the Review view:
- View the full diff of changes
- Set a disposition: accept, reject, or revise
- If you choose revise, add feedback and the agent iterates
Land
Once accepted, land the changes:
kavi landYour validated changes are merged into the branch. Done.
Recap
npm install -g @mandipadk7/kavi # Install
kavi doctor # Check prerequisites
kavi init # Initialize project
kavi open # Launch TUI
# Compose -> Route -> Approve -> Review
kavi land # Merge validated work