Skip to content

Attocode

Production AI coding agent built in Python. Features a Textual-based TUI, multi-agent swarm orchestration, intelligent budget management, and a safety sandbox system.

Highlights

  • Interactive TUI --- Rich terminal interface with live tool status, streaming, plan/task panels, and keyboard shortcuts
  • Swarm mode --- Multi-agent orchestration with dependency-aware wave scheduling and parallel workers
  • Budget management --- Token-based economics with doom-loop detection and phase tracking
  • Safety sandbox --- Platform-aware command isolation (Seatbelt on macOS, Landlock on Linux, Docker, or allowlist fallback)
  • Session persistence --- SQLite-backed sessions, checkpoints, goals, and permission grants
  • Multi-provider --- Anthropic, OpenRouter, and OpenAI adapters
  • Skills & agents --- Extensible skill and agent system with project-level and user-level customization
  • Research campaigns --- Multi-experiment research workflows with dedicated worktrees, hypothesis tracking, and persistent campaign state
  • Code intelligence --- 36-language AST parsing, semantic search, dependency graphs, architecture analysis via MCP server
  • MCP support --- Connect external tools via the Model Context Protocol

Quick Start

# Install
pip install -e ".[dev]"

# Set your API key
export ANTHROPIC_API_KEY="sk-ant-..."

# Interactive TUI
attocode

# Single-turn
attocode "List all Python files in this project"

# Swarm mode
attocode --swarm "Build a REST API with tests"

Project Stats

Metric Count
Source files ~450
Source lines ~122,000
Test files 120+
Total tests 3,370+

Next Steps