Installation

Install Kavi

Install Kavi globally:

npm install -g @mandipadk7/kavi

Verify the installation:

kavi --version

Run without installing:

npx @mandipadk7/kavi

All four prerequisites below must be installed and configured before Kavi can run. Use kavi doctor to verify everything at once.

Kavi orchestrates two AI agents -- Claude Code CLI and Codex CLI -- and needs a few things in place before it can work.

Kavi requires Node.js v18 or later. Check your version:

node --version

If you need to install or upgrade Node.js, use nvm, fnm, or download directly from nodejs.org.

Kavi manages sessions and state within git repositories. Confirm git is available:

git --version

The Claude Code CLI must be installed and authenticated. Install it following the official instructions, then verify:

claude --version

Make sure you have completed authentication. Claude CLI should be able to respond to prompts without asking you to log in.

The OpenAI Codex CLI must also be installed. Install it via npm:

npm install -g @openai/codex

Verify it is available:

codex --version

Once all prerequisites are installed, run the built-in diagnostic:

kavi doctor

This command checks for:

If any check fails, kavi doctor prints a clear explanation and remediation steps.

Set up project and user configuration with kavi init