cc-mini
Ultra-light Harness scaffolding for AI agents, a mini version of claude code
cc-mini is an ultra-lightweight AI coding agent framework built in approximately 1,000 lines of Python, inspired by Claude Code. It provides an interactive REPL with streaming output where AI agents autonomously call tools until tasks complete, supporting both Anthropic and OpenAI-compatible APIs. The framework includes nine built-in tools for file operations, shell commands, and planning, plus advanced features like parallel subagents, cross-session memory (KAIROS), custom workflows (skills), and an AI companion pet called Buddy. Developers use it as a terminal-based coding assistant or extend it with project-specific skills and sandboxed execution environments.
Key Features
Use Cases
- 01Terminal-based AI coding assistant for exploring codebases and implementing features autonomously
- 02Code review automation using built-in /review skill to analyze git diffs and provide feedback
- 03Parallel codebase research with plan mode subagents exploring different files simultaneously
- 04Custom workflow automation through project-specific skills for testing, commits, and code simplification
- 05Long-running coding sessions with context compression and cross-session memory persistence
- 06Sandboxed command execution for safely running bash tools in isolated environments
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
cc-mini — FAQ
What is cc-mini?+
cc-mini is an ultra-lightweight AI agent framework for coding assistance, built in ~1,000 lines of Python. It provides an interactive REPL where AI agents autonomously call tools to complete tasks, with support for both Anthropic and OpenAI-compatible APIs.
How do I install cc-mini?+
Install with the one-line command: curl -fsSL https://raw.githubusercontent.com/e10nMa2k/cc-mini/main/install.sh | bash. Alternatively, clone the repository and run pip install -e ".[dev]" from the cc-mini directory. Requires Python 3.10+ (3.11+ recommended).
Do I need an API key to use cc-mini?+
Yes, you need either an Anthropic API key (export ANTHROPIC_API_KEY=sk-ant-...) or an OpenAI-compatible API key (export OPENAI_API_KEY=sk-... and export CC_MINI_PROVIDER=openai). Azure AI Foundry and other OpenAI-compatible gateways are supported by setting OPENAI_BASE_URL.
Which AI clients work with cc-mini?+
cc-mini is a standalone terminal-based agent that runs independently, not a plugin for other AI clients. It works with any Anthropic or OpenAI-compatible API endpoint, including Azure AI Foundry and custom gateways.
Is cc-mini free to use?+
Yes, cc-mini itself is free and open-source. However, you'll incur API costs from your chosen provider (Anthropic, OpenAI, or compatible gateway) based on token usage.
How do I create custom skills for cc-mini?+
Place custom skill files in ~/.cc-mini/skills/ for user-level skills or {project}/.cc-mini/skills/ for project-specific skills. Skills are one-command workflows accessible via slash commands like /review, /commit, /test. See docs/skills.md and docs/examples/citorigin for examples.
How do I install cc-mini?+
Open the source repository on GitHub and follow its README. cc-mini is a agent — MCP Agents Market links you directly to the official repo.
Is cc-mini free?+
cc-mini is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.