Terminal AI coding companion

A Code Assistant for Your Terminal

KaiCode is a powerful command-line agent designed to help you edit codebases, run test diagnostics, and build complex applications directly from the terminal.

$pip install kaicode

kaicode CLI v2.1.0

```
██╗ ██╗ █████╗ ██╗ ██████╗
██║ ██╔╝██╔══██╗██║██╔════╝
█████╔╝ ███████║██║██║
╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═════╝ by Kai Cyrus
```

# Auto-detecting context...

✓ React & Tailwind project detected

# Initializing Ollama (llama3.2)...

❯ /provider anthropic

✓ Switched provider to Anthropic (model: claude-3-5-sonnet)

❯ Add a dark theme button on layout

✓ File modified: src/components/layout/nav.tsx (+14, -2)

✓ View diff using `/diff` command

❯

Core Agentic Features

Multiple AI Providers

Switch dynamically between local models via Ollama (default), Anthropic Claude, OpenAI, and Groq API systems.

Agentic Engineering Tools

Autonomously read and edit files with surgical diffs, run commands, list directory trees, and search codebases.

Smart Project Context

Auto-detects active stack settings (Next.js, Flutter, Python, Rust, Go) to customize workspace search and prompts.

Interactive CLI Commands

Control your AI session directly using slash commands like /model, /provider, /diff, /save, and /load.

VCS & Git Integration

Perform quick repository diagnostic status queries and commit modifications directly inside the CLI.

Beautiful Syntax Diffs

Enjoy gorgeous terminal colorized outputs rendering diff lines, file trees, and markdown payloads.

Installation & Quickstart

Standard Package Install

Use the pip manager to fetch the latest compiled build.

# Install stable release

$ pip install kaicode

# Boot the assistant console

$ kaicode

Compile From Source

Clone the repository to run or modify the codebase locally.

# Clone public repository

$ git clone https://github.com/kaicyrusdgreat/kaicode

$ cd kaicode

# Install in editable mode

$ pip install -e .

Configuration Schema

# Global configuration: ~/.kaicode/config.yaml

default_provider: ollama

providers:

ollama:

base_url: http://localhost:11434

default_model: llama3.2

anthropic:

api_key: sk-ant-your-key-here

default_model: claude-sonnet-4-6

Console Slash Commands

Command Option	Action Description
/model [name]	Switch models or view available list
/provider [name]	Switch provider engines dynamically
/diff	Display the last applied files modification diff
/save [name]	Save current conversation session history
/load <name>	Restore a previously saved session
/sessions	List all archived sessions
/context	Show auto-detected context and matching files
/status	Review token usage, model, and active provider info
/clear	Wipe active context and clear scrollback
/quit	Exit assistant prompt interface securely

Initializing...