codefreedom 0.2.1.dev1

Unified interface for all code agents — LLM proxy routing, Docker sandboxing, profile management, and browser tools. Switch models and providers without reconfiguring.

CodeFreedom

Unified interface for all code agents. Simple LLM routing. Sandboxing just a click away.

Full documentation: https://nilayparikh.github.io/codefreedom/

What is CodeFreedom?

The Problem

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.

The Solution

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:

1. Switch models and providers -- change your backend without reconfiguring your agent.
2. Isolate environments -- reproducible, sandboxed sessions per project with GPU support.
3. 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.

Supported Agents

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.

Video Walkthrough

Quick Start

Install

pip install codefreedom

Pick a recipe and set up

# See available recipes
cf s i -l

# Plan + apply a recipe (recommended -- shows preview, prompts to confirm)
cf s i -pa costeffective-coding

A recipe is a pre-built configuration bundle that wires up proxy, profiles, and provider settings in one step. See recipes/ for options.

Start the proxy and launch an agent

# 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

Common commands

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.

Features

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

Requirements

• Python 3.10+
• Docker -- required for sandbox mode and the proxy
• Node.js -- for local mode (agent-specific)

Principles

• 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. ~/.codefreedom is the single source of truth.

Data Privacy

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.

Disclaimer

CodeFreedom is provided "as is" without warranty of any kind. Use at your own risk. See NOTICE for trademark and third-party disclaimers.

License

Apache 2.0 -- see LICENSE.