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. Puppeteer mode orchestrates agents across multiple projects in a monorepo or multi-repo setup.

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.

16 AI providers built in

GitHub Copilot, OpenAI, Google Gemini, DeepSeek, OpenRouter, MiniMax, llama.cpp, LM Studio, SAM, and any OpenAI-compatible endpoint. Switch providers mid-session.

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

Part of the ecosystem

CLIO + SAM Shared Methodology

CLIO develops SAM. Both use the Unbroken Method. Shared long-term memory patterns, collaboration checkpoints, and structured handoffs. What CLIO learns building SAM, it applies to your projects.

CLIO + ALICE Remote Image Generation

Use CLIO's remote execution to deploy ALICE on any machine in your fleet. Install ALICE on GPU servers, trigger generation tasks from your terminal, and retrieve results — all through CLIO's SSH-based remote execution.

CLIO Skills Extensible Intelligence

Load custom skills from Git repositories. Create domain-specific agents for your stack. Skills are just prompts + tools - share them across your team or the community.

Give it a task. Ship the work.

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