Kairos

Kairos is an autonomous AI coding agent that lives in your terminal — in the spirit of Claude Code, but bring-your-own-provider. Point it at Anthropic, OpenAI, Groq, Cerebras, DeepSeek, Gemini, Mistral, Cohere, Ollama, or OpenRouter, and it plans, edits files, runs commands, tests, and iterates, right where you already work.

npx kairos

That's it. No servers, no database, no config file to write by hand.

What it does

• Plans and executes multi-step coding tasks autonomously
• 64 built-in tools: file I/O, search/replace across a repo, git, shell commands, linting/formatting, tests + coverage, dependency inspection, and more (kairos --list-tools)
• 10 providers, switchable mid-session (kairos --list-providers)
• Diff-first editing — changes are staged and previewed, not blind overwrites
• Project memory — remembers what worked (and what didn't) across a session
• Works entirely in-memory by default; point DATABASE_URL at a Postgres instance if you want history to persist across restarts — totally optional

Install

npm install -g kairos

or just run it on demand with npx kairos, no install required.

Usage

kairos                                   # interactive session
kairos "refactor the auth module"        # one-shot task
kairos -p groq -m llama-4-scout "explain this repo"

On first use, set an API key for your provider:

export ANTHROPIC_API_KEY=sk-...
# or, inside a session:
/key sk-...

In-session commands

| Command | What it does | |---|---| | /help | show all commands | | /provider <name> | switch provider | | /model <name> | switch model | | /key <value> | set the API key for the current provider | | /dir <path> | change working directory | | /tools | list every tool the agent can call | | /status | show current provider, model, directory | | /clear | clear the screen | | /exit | quit |

CLI flags

-p, --provider <name>   provider to use
-m, --model <name>      model to use
-k, --key <value>       API key for the chosen provider
--list-tools            list every tool the agent can call
--list-providers        list every supported provider + model
-v, --version           print the version number

Providers

| Provider | Tool calling | |---|---| | anthropic | ✓ | | openai | ✓ | | groq | ✓ | | cerebras | ✓ | | deepseek | ✓ | | gemini | ✓ | | mistral | ✓ | | openrouter | ✓ | | cohere | text-only | | ollama | text-only, local |

Config and API keys are stored locally at ~/.kairos/config.json.

License

MIT