https://github.com/dkmnx/kairo
Kairo: Securely orchestrate multiple AI providers via Anthropic. Hardened with X25519 (age) encryption, integrated audit trails, and a terminal-native interface.
https://github.com/dkmnx/kairo
agentic-coding anthropic claude claude-code clauver cli deepseek deepseek-v4 deepseek-v4-flash deepseek-v4-pro glm-5-1 kimi kimi-k2-6 minimax minimax-m2-7 zai
Last synced: 11 days ago
JSON representation
Kairo: Securely orchestrate multiple AI providers via Anthropic. Hardened with X25519 (age) encryption, integrated audit trails, and a terminal-native interface.
- Host: GitHub
- URL: https://github.com/dkmnx/kairo
- Owner: dkmnx
- License: mit
- Created: 2025-12-25T11:42:52.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-05-27T03:52:33.000Z (14 days ago)
- Last Synced: 2026-05-27T04:27:06.423Z (14 days ago)
- Topics: agentic-coding, anthropic, claude, claude-code, clauver, cli, deepseek, deepseek-v4, deepseek-v4-flash, deepseek-v4-pro, glm-5-1, kimi, kimi-k2-6, minimax, minimax-m2-7, zai
- Language: Go
- Homepage:
- Size: 1.24 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing/README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Kairo
```text
__ .__
| | _______ |__|______ ____
| |/ /\__ \ | \_ __ \/ _ \
| < / __ \| || | \( <_> )
|__|_ \(____ /__||__| \____/
\/ \/
```
[](https://github.com/dkmnx/kairo/releases)
[](https://go.dev/dl/)
[](https://github.com/dkmnx/kairo/actions)
[](LICENSE)
**One CLI for every AI coding agent. Keys encrypted, providers unlocked.**
## Overview
Kairo provides multi-provider API management with secure credential storage:
- **Multi-harness**: Claude Code, Qwen Code, and Pi
- **Secure encryption**: age/X25519 for all API keys at rest
- **Built-in providers**: Z.AI, MiniMax, Moonshot AI, DeepSeek, Anthropic, OpenAI, Google, Mistral, Groq, Cerebras, Cloudflare Workers AI, xAI, OpenRouter, Vercel AI Gateway, OpenCode, Hugging Face, Fireworks, Azure OpenAI, and custom providers
- **Cross-platform**: Linux, macOS, Windows
## Quick Start
### Install
- Linux/macOS: `curl -sSL https://raw.githubusercontent.com/dkmnx/kairo/main/scripts/install.sh | sh`
- Windows: `irm https://raw.githubusercontent.com/dkmnx/kairo/main/scripts/install.ps1 | iex`
### Prerequisites
Install one of the supported harness CLIs:
```bash
# Claude Code
npm install -g @anthropic-ai/claude-code
# Qwen Code
npm install -g @qwen-code/qwen-code@latest
# Pi
npm install -g @earendil-works/pi-coding-agent
```
### Setup
```bash
kairo setup # Interactive setup wizard
kairo list # List configured providers
kairo zai "query" # Use a specific provider
kairo -- "query" # Use the default provider
```
## Commands
| Command | Description |
| ----------------------------- | ----------------------------------------------- |
| `kairo setup` | Interactive setup wizard |
| `kairo setup --reset-secrets` | Regenerate encryption key and re-enter API keys |
| `kairo list` | List configured providers |
| `kairo default [provider]` | Get or set the default provider |
| `kairo delete ` | Delete a provider |
| `kairo [args]` | Execute with a specific provider |
| `kairo -- [args]` | Execute with the default provider |
| `kairo harness get` | Get the current harness |
| `kairo harness set ` | Set the default harness |
| `kairo update` | Update to the latest version |
| `kairo version` | Show version information |
| `kairo completion [shell]` | Generate shell completion script |
Full reference: [cmd/README.md](cmd/README.md)
## Configuration
Locations:
- Linux/macOS: `~/.config/kairo/`
- Windows: `%USERPROFILE%\AppData\Roaming\kairo\`
Files:
- `config.yaml` - provider and harness settings
- `secrets.age` - encrypted API keys
- `age.key` - encryption private key
## Security
- X25519 encryption for all API keys
- `0600` permissions on sensitive files
- In-memory decryption during use
- Temporary wrapper scripts for secure token passing to harness CLIs
- Recovery/reset flow via `kairo setup --reset-secrets`
See [Security Architecture](docs/architecture/README.md#security-architecture)
## Documentation
- [User Guide](docs/guides/user-guide.md) - Installation and usage
- [Development Guide](docs/guides/development-guide.md) - Setup and contribution
- [Architecture](docs/architecture/README.md) - System design
- [Troubleshooting](docs/troubleshooting/README.md) - Common issues
Full documentation: [docs/README.md](docs/README.md)
## Development
```bash
just build
just test
just lint
just pre-release
```
## Resources
- [GitHub](https://github.com/dkmnx/kairo)
- [Report Issues](https://github.com/dkmnx/kairo/issues)
---
**License:** [MIT](LICENSE) | **Author:** [dkmnx](https://github.com/dkmnx)