Unified interface for all code agents. Simple LLM routing. Sandboxing just a click away.
Full documentation: https://nilayparikh.github.io/codefreedom/
AI code agents are powerful, but the ecosystem around them is fragmented. Each agent carries its own configuration, model preferences, and runtime dependencies. There is no portable layer that lets you move between agents, models, or providers without starting over.
That fragmentation creates three compounding risks:
- Vendor lock-in -- choosing a provider today can constrain your choices tomorrow. As the model landscape evolves, being tied to one ecosystem means missing better capabilities, pricing, or reliability from competitors.
- Unmanaged cost -- without visibility across providers, there is no way to route work to the most cost-effective model. Token spend grows unchecked because switching providers is a manual, error-prone process.
- Complexity as a barrier -- setting up proxies, sandboxes, and provider integrations demands infrastructure expertise. Developers who should be building products spend time plumbing tooling, or avoid the tools altogether.
CodeFreedom is a CLI that sits between you and your code agent (Claude Code, MiMoCode, OpenCode, etc.). It provides a portable abstraction layer so you can:
- Switch models and providers -- change your backend without reconfiguring your agent.
- Isolate environments -- reproducible, sandboxed sessions per project with GPU support.
- Manage everything from one place -- profiles, proxy routing, and sandbox settings live in
~/.codefreedom.
It orchestrates agents through their publicly supported interfaces (environment variables, CLI flags, API endpoints). No patching, no reverse-engineering.
| Agent | Alias | Description |
|---|---|---|
| Claude Code | cc |
Anthropic's code agent |
| MiMoCode | mc |
Xiaomi's code agent |
| OpenCode | oc |
OpenCode code agent |
All agents share the same proxy, sandbox, and tooling layers.
pip install codefreedom# See available recipes
cf s i -l
# Plan + apply a recipe (recommended -- shows preview, prompts to confirm)
cf s i -pa costeffective-codingA recipe is a pre-built configuration bundle that wires up proxy, profiles, and provider settings in one step. See recipes/ for options.
# Start the LiteLLM proxy (auto-starts browser tools)
cf r px start
# Launch your agent
cf r ag cc # Claude Code
cf r ag mc # MiMoCode
cf r ag oc # OpenCode
# Or launch in a sandboxed container
cf r ag cc --sandbox
cf r ag cc --sandbox --cuda # NVIDIA GPU
cf r ag cc --sandbox --rocm # AMD GPU| Command | What it does |
|---|---|
cf s i -l |
List available recipes |
cf s i -pa <recipe> |
Plan + apply a recipe |
cf r px start |
Start proxy + tools |
cf r px stop |
Stop proxy + tools |
cf r px status |
Check proxy health |
cf r ag cc |
Launch Claude Code |
cf r ag mc |
Launch MiMoCode |
cf r ag oc |
Launch OpenCode |
cf run tools status |
Check tool container status |
cf manage admin backup |
Backup config |
cf manage doctor |
Diagnose issues |
See the full documentation for proxy setup, custom profiles, browser tools, and more.
| Feature | Details |
|---|---|
| LLM proxy | Self-hosted LiteLLM image (embedded PostgreSQL, multi-provider routing) |
| Agent launcher | Claude Code, MiMoCode, OpenCode -- local + sandbox modes |
| Sandboxing | Pre-configured containers (CPU, CUDA, ROCm) for each agent |
| Profiles | Model switching, env inheritance, isolation |
| Browser tools | Chrome (CDP + MCP), Camoufox stealth browser (MCP), GitHub MCP, Web Bridge |
| Backup & restore | Config backups with diff preview and selective restore |
- Python 3.10+
- Docker -- required for sandbox mode and the proxy
- Node.js -- for local mode (agent-specific)
- Just configuration. Profiles are environment variables. Proxy routing is standard LiteLLM config.
- Opt-in providers. Set an API key to enable a provider. Leave it empty to disable. Nothing phones home.
- All config in one place.
~/.codefreedomis the single source of truth.
CodeFreedom is a local configuration tool. It does not collect telemetry, connect to external servers, or store/transmit your prompts, code, or API keys.
All configuration lives on your machine in ~/.codefreedom/. You are responsible for reviewing the privacy policies of every provider and tool you configure.
CodeFreedom is provided "as is" without warranty of any kind. Use at your own risk. See NOTICE for trademark and third-party disclaimers.
Apache 2.0 -- see LICENSE.