Getting Started

Introduction & Sovereign Architecture

Full-lifecycle sovereign AI coding CLI built in pure Rust with zero telemetry and local-first execution.

What is CACode?

CACode is a high-speed, autonomous software engineering agent and interactive terminal assistant written entirely in Rust. Designed for professional software developers, CACode combines the flexibility of modern Large Language Models (LLMs) with the strict boundaries of local data sovereignty and deterministic tool safety.

Core Architectural Pillars:

  • 100% Pure Rust Performance: Instant boot times (< 15ms), low memory footprint (< 25MB RSS), and zero runtime garbage collection pauses.
  • Deterministic ReAct Loop: Autonomous reasoning and action loop that produces structured, human-reviewable plans before touching a single line of your codebase.
  • The 5 Sovereign Tools: Purpose-built primitives for file reading, targeted patching, workspace search, terminal execution, and symbol extraction with strict permission gating.
  • Zero Telemetry & BYOK: Direct connection to any AI provider (Anthropic, OpenAI, DeepSeek, Google Gemini) or local models (Ollama, vLLM) via Bring-Your-Own-Key. No proprietary cloud proxies harvesting your code.
  • Local Hyper Proxy (:8000): Embedded local HTTP reverse proxy and token monitor that tracks latency, enforces spend limits, and caches repetitive system prompts.
  • reedline Interactive CLI: Modern terminal experience featuring syntax-highlighted multiline editing, history search, and ergonomic slash commands.

Comparison Matrix

Feature CACode Generic AI Assistants
Binary Footprint Single native binary (< 20MB) Heavy Node.js / Python runtimes (> 200MB)
Telemetry Zero (Strictly local-first) Code snippet logging & remote telemetry
Local Model Support Native Ollama / vLLM / llama.cpp Cloud-only vendor lock-in
Cost Tracking Local SQLite ledger with token-level accuracy Opaque monthly cloud bills