CLIO

Your AI development agent.

Describe a task. CLIO reads your code, makes changes, runs tests, and commits - iterating until the work is done. Interrupt it mid-task to redirect, and it picks up exactly where you left off next session.

Free and open source. ~50MB. Zero external dependencies. macOS and Linux.

CLIO

An agent that works, not just suggests.

End-to-end execution

CLIO doesn't hand you a snippet and walk away. It reads your code, makes changes, runs tests, fixes errors, and commits - autonomously, from start to finish.

Interrupt anytime

Press any key to stop CLIO mid-task. It pauses, asks what you need, and adapts its approach - like tapping your pair programmer on the shoulder.

Remembers across sessions

Long-term memory stores project discoveries, solved problems, and code patterns. Every new session starts with what CLIO learned last time - no re-explaining.

Learns your style

Run /profile build and CLIO analyzes your session history to learn how you communicate, what you prefer, and how to work with you - across every project.

Parallel multi-agent work

Spawn multiple AI agents to tackle different parts of a problem simultaneously. File and git locking prevent conflicts. Live output streams in separate tmux, screen, or Zellij panes.

Remote fleet execution

SSH into any machine, run an AI task, get results back. Execute across your entire fleet in parallel - diagnostics, builds, analysis, deployment.

Know what you're spending

Track token usage, premium request counts, and GitHub Copilot quota with /usage (or /billing - same thing). See your billing rate multiplier, quota remaining, and reset date at a glance.

Secrets stay secret

Built-in secret redaction catches API keys, tokens, passwords, and PII before they reach any AI provider. Your credentials never leave your machine.

Zero dependencies

Pure Perl. ~50MB at startup. No npm, no pip, no CPAN. Runs on anything from a ClockworkPi uConsole to an M4 Mac. Install via Homebrew, Docker, or a single script.

Full access to your codebase.

CLIO reads, writes, searches, and refactors files across your entire project. Apply surgical patches across multiple files. Undo any AI change with a single command. Run shell commands, build tools, test suites - all from the same session.

Semantic search understands code structure. Ask "where is authentication implemented?" and CLIO finds it - even if the file doesn't contain that word.

File Operations

Pick up exactly where you left off.

Sessions persist. Resume any conversation with full history intact. CLIO tracks multi-step tasks with structured todos, maintains momentum across long sessions, and exports complete session transcripts to HTML for documentation and review.

Context trimming keeps long sessions sharp - CLIO automatically compresses older messages into summaries so it never loses the thread of what you're working on.

Task Tracking

Built on a methodology, not just prompts.

CLIO implements The Unbroken Method - a systematic approach to AI collaboration that maintains continuous context, demands complete ownership, and learns from failure.

Collaboration checkpoints keep the agent aligned. Long-term memory persists what it learns. Todo tracking ensures nothing gets dropped. CLIO doesn't just respond - it works through problems end-to-end with a methodology that scales to real projects.

Methodology

Give it a task. Ship the work.

Start with GitHub Copilot - no API key setup, just log in and go. Swap providers anytime.