docs
Everything Kadhai does, explained.
From installing it to automating work with flows. New here? Read Getting started and stop there; come back to the rest when you need it.
01What Kadhai isKadhai is a workspace that runs on your own computer, where a small crew of AI agents builds software, checks it and automates chores for you. You...02Getting startedOpen a terminal in the Kadhai folder and run:03A tour of the screenOn a phone the taskbar keeps only kitchens, crew, the flame and more; terminal, keys, flows, connect, providers and the layout lock are inside more.04Giving the crew workType in the chat and press Enter. Write it the way you would brief a colleague: what you want, any constraints (one file, no frameworks, use the...05The crewAgents never talk to each other directly and never see chat history; plain code passes the work between them, and every step has a fixed limit on how...06Models and keysOpen keys in the taskbar. The providers you use come first, each with its keys (only ever shown masked) and its models.07Low flame and high flameThe flame in the taskbar sets how much the crew may use per call. Any key works on either.08Files, terminal, browser and source controlOpen a file to see it with syntax highlighting; Edit and Save (Ctrl+S) change it. .js and .py files have Run, .html files have Preview.09FlowsA flow is an automation you draw: something that starts it, then steps joined by wires. Data travels along the wires, and any setting can use it....10Connections and tasks from outsideconnect opens a catalog of about fifty services the crew can use while it works: web search, a browser, GitHub, Notion, Linear, Slack, databases and...11KitchensClick kitchens in the taskbar and + new kitchen to open another folder in its own window, with its own crew, chat, memory, flows and triggers,...12Memory and lessonsKadhai remembers what was done in each folder, in plain files inside its hidden .kadhai folder:13Themes and appearancemore -> Theme offers nine themes. Each changes more than colour: typefaces, shapes, window style, background and effects. The kitchen takes deeper...14Using Kadhai from other appsOther AI tools (Claude Desktop, Claude Code, Cursor) can use the crew and the folder through MCP. Tools offered: kadhai_run_task,...15Safety and privacyThe crew can run commands it writes, such as tests. By default each one waits for your OK.16Settings file (.env)Keys and models are easiest to manage in the dashboard. Everything else can go in a .env file in the Kadhai folder; copy .env.example to .env and...17Troubleshooting"Kadhai is not answering. Is it still running?"
The server was stopped (the terminal was closed, or the computer slept). Start it again with npm...18Glossary
for developers
Working on Kadhai itself?
The developer guide covers the architecture, the life of a run, where data lives, the rules a change must keep, and testing.
privacy
What leaves your computer
No telemetry. Prompts go only to the model providers you add keys for. The privacy page says exactly what is sent, when, and to whom.