https://github.com/dkmnx/kairo
Go port of clauver - A secure CLI tool for managing and switching between Claude Code API providers including Anthropic, Z.AI, MiniMax, and custom providers with age (X25519) encryption.
https://github.com/dkmnx/kairo
agentic-coding anthropic claude claude-code clauver cli deepseek deepseek-v3-2 glm-4-7 kimi kimi-k2 minimax minimax-m2-1 zai
Last synced: 3 days ago
JSON representation
Go port of clauver - A secure CLI tool for managing and switching between Claude Code API providers including Anthropic, Z.AI, MiniMax, and custom providers with age (X25519) encryption.
- Host: GitHub
- URL: https://github.com/dkmnx/kairo
- Owner: dkmnx
- License: mit
- Created: 2025-12-25T11:42:52.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-01-28T03:06:36.000Z (6 days ago)
- Last Synced: 2026-01-28T17:57:00.524Z (6 days ago)
- Topics: agentic-coding, anthropic, claude, claude-code, clauver, cli, deepseek, deepseek-v3-2, glm-4-7, kimi, kimi-k2, minimax, minimax-m2-1, zai
- Language: Go
- Homepage:
- Size: 567 KB
- Stars: 2
- Watchers: 1
- 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)
**Secure CLI for managing Claude Code API providers** with age (X25519) encryption, multi-provider support, and audit logging.
## Prerequisites
### Required: Claude Code CLI
Kairo acts as a wrapper around Claude Code CLI to enable multi-provider support. You need to install Claude Code first.
**Install Claude Code:**
- Visit:
- Or via package managers:
```bash
# Homebrew (macOS)
brew install --cask claude-code
# npm
npm install -g @anthropic-ai/claude-code
```
**Verify installation:**
```bash
claude --version
```
## Quick Start
### Linux/macOS
```bash
# Install
curl -sSL https://raw.githubusercontent.com/dkmnx/kairo/main/scripts/install.sh | sh
```
### Windows (PowerShell)
```powershell
# Install
irm https://raw.githubusercontent.com/dkmnx/kairo/main/scripts/install.ps1 | iex
```
### Setup
```bash
kairo setup
# Configure a provider
kairo config zai
# Test provider
kairo test zai
# Switch and query
kairo switch zai "Help me write a function"
# Or use default provider
kairo -- "Quick question"
```
### PATH Configuration
After installation, add the binary to your PATH:
**Linux/macOS:**
```bash
export PATH="$HOME/.local/bin:$PATH"
```
**Windows (PowerShell):**
```powershell
# Current session:
$env:PATH += ";$env:LOCALAPPDATA\Programs\kairo"
# Permanent:
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$env:LOCALAPPDATA\Programs\kairo", [EnvironmentVariableTarget]::User)
```
### Manual Installation
Download the latest release from [GitHub Releases](https://github.com/dkmnx/kairo/releases), extract the archive, and
place the binary in your PATH.
## Commands
| Command | Description |
| ----------------------------- | ---------------------------------- |
| `kairo setup` | Interactive setup wizard |
| `kairo config ` | Configure a provider |
| `kairo list` | List configured providers |
| `kairo status` | Test all providers |
| `kairo test ` | Test specific provider |
| `kairo switch ` | Switch and exec Claude |
| `kairo default ` | Get/set default provider |
| `kairo reset ` | Remove provider config |
| `kairo rotate` | Rotate encryption key |
| `kairo audit ` | View/export audit logs |
| `kairo -- "query"` | Query mode (default provider) |
| `kairo version` | Show version info |
| `kairo update` | Check for updates |
## Features
| Feature | Description |
| ------------------------ | ------------------------------------------------------------------------ |
| **Multi-Provider** | Native Anthropic, Z.AI, MiniMax, Kimi, DeepSeek, custom |
| **Secure Encryption** | Age (X25519) encryption for all API keys |
| **Key Rotation** | Regenerate encryption keys periodically |
| **Audit Logging** | Track all configuration changes |
| **Interactive Setup** | Guided configuration wizard |
| **Provider Testing** | Test connectivity and configuration |
| **Auto-Update** | Notifications for new versions |
## Documentation
**User Guides:**
- [User Guide](docs/guides/user-guide.md) - Installation and usage
- [Audit Guide](docs/guides/audit-guide.md) - Audit log usage
- [Integration Examples](docs/guides/claude-integration-examples.md) - Practical workflows
**Developer Resources:**
- [Development Guide](docs/guides/development-guide.md) - Setup and contribution
- [Architecture](docs/architecture/README.md) - System design and diagrams
- [Contributing](docs/contributing/README.md) - Contribution workflow
**Reference:**
- [Troubleshooting](docs/troubleshooting/README.md) - Common issues and solutions
- [Changelog](CHANGELOG.md) - Version history
## Modules
```text
kairo/
├── cmd/ # CLI commands (Cobra) → [cmd/README.md](cmd/README.md)
├── internal/ # Business logic
│ ├── audit/ # Audit logging
│ ├── config/ # Configuration loading
│ ├── crypto/ # Age encryption
│ ├── providers/ # Provider registry
│ ├── validate/ # Input validation
│ └── ui/ # Terminal output
└── pkg/ # Reusable utilities → [pkg/README.md](pkg/README.md)
```
## Configuration
Location: `~/.config/kairo/`
| File | Purpose | Permissions |
| ------------- | --------------------------------- | ----------- |
| `config` | Provider configurations (YAML) | 0600 |
| `secrets.age` | Encrypted API keys | 0600 |
| `age.key` | Encryption private key | 0600 |
| `audit.log` | Configuration change history | 0600 |
## Building
```bash
make build # Build to dist/kairo
make test # Run tests with race detection
make lint # Run code quality checks
make format # Format code with gofmt
```
## Security
- Age (X25519) encryption for all API keys
- 0600 permissions on sensitive files
- Secrets decrypted in-memory only
- Key generation on first run
- Use `kairo rotate` for periodic key rotation
## License
[MIT](LICENSE) (c) 2025 [dkmnx](https://github.com/dkmnx)
## Resources
- [GitHub](https://github.com/dkmnx/kairo)
- [Report Issues](https://github.com/dkmnx/kairo/issues)