/init learns your project
It reads your code once and notes your test commands, style and conventions in Kaivo.md.
Kaivo CLI 1.15.0 · Windows, macOS, Linux
Something to fix? Kaivo can do it.
A bug you can't solve? Open your terminal, type “fix my problem, please”, and Kaivo reads your project, finds the cause and proposes the fix.
Install in one command
PS> irm https://kaivoia.site/install.ps1 | iexRun it in PowerShell. Then open a new terminal in your project and type kaivo.
kaivo — ~/my-project
Illustrative example: the project and files are made up.
It reads, fixes and checks.
In your terminal, on your real projects. One account for the CLI and the website.
- 1
You describe the problem
One sentence is enough: “the cart total shows NaN”.
- 2
It goes looking
It opens the files, reads the Git history and runs the tests to see the error.
- 3
It shows you the cause
In one sentence, before touching anything. You decide whether to go on.
- 4
It fixes and checks
The change is made, the tests pass again. You see exactly what moved.
kaivo — ~/shop
› /fix the cart total shows NaN
● view src/cart.js
● bash npm test ✗ 1
Cause: prices are written “49,90”, and Number() returns NaN.
Kaivo asks before changing anything [Yes] [No]
- const total = items.reduce((s, i) => s + Number(i.price), 0);
+ const total = items.reduce((s, i) => s + Number(String(i.price).replace(",", ".")), 0);
✓ npm test: 14 tests pass
Everything you need, nothing that acts behind your back.
/plan before touching
On a big task, ask for a plan: it reads the whole project but changes nothing.
/goal, step by step
Give a goal like “add a dark mode”. It splits it into short steps and asks before each change.
/verify runs the tests
Build, lint and tests run, then it tells you what passes, what fails and why.
/review and /security-review
Likely bugs, things forgotten, hard-coded secrets, unchecked input. Most serious first.
--read-only to just look
On a project you don't know, it explores and explains without being able to touch it.
/commit with a clear message
It reads your changes, proposes a message and only commits if you agree.
A chat when an agent is too much
A question or a small script: open the chat in your browser, nothing to install.
64 commands. Type / and go.
See them all with examples →Conversation8
/new/sessions/rename/export/copy/recapWorking on the project13/init/plan/goal/explain/fix/commitReview and check6/diff/review/security-review/simplify/verify/runModel and permissions7/mcp/model/theme/readonly/custom-key/bypassAccount and maintenance11/status/stats/usage/doctor/update/versionHelp and links5/help/docs/feedback/logs/quitTerminal14kaivokaivo loginkaivo signupkaivo logoutkaivo whoamikaivo -p