freecode

Claude Code workflow on free LLM providers.

freecode is a thin shim over opencode-ai + freellmapi that ports the Claude Code CLI surface onto free-tier LLM providers (OpenRouter, Groq, Cloudflare Workers AI, Gemini, Zhipu, Cerebras).

Install

npm install -g @corginpm/freecode
freecode setup        # guided onboarding (5 steps, idempotent)
freecode --print "hello"

Or, in a project directory:

freecode               # interactive TUI

What you get

100% functional parity with Claude Code's tool surface on free LLMs:

• opencode built-ins — bash, read, write, edit, grep, glob, todowrite, webfetch, websearch, question, skill, apply_patch, lsp
• freecode-added tools — task / task_bg / task_output (subagent dispatch), enter_plan_mode / exit_plan_mode, notebook_edit, schedule_wakeup, monitor_start / monitor_read / monitor_stop, push_notification, tool_search
• Hooks — PreToolUse / PostToolUse / UserPromptSubmit / SessionStart / Stop / PreCompact / Notification (translated from ~/.claude.json)
• MCP — per-server trust gate (freecode trust mcp <name>)
• Sessions — persist + resume + HMAC integrity verify
• Permissions — allow/ask/deny baked from ~/.claude.json
• Memory — project CLAUDE.md (always) + ~/.claude/CLAUDE.md (opt-in)
• Security — OS keyring at-rest token encryption (req-3), session-log redaction (req-8), workspace-trust gate (req-11), FS-perm re-check on launch (req-12), MCP trust (req-10), Windows hook-timeout kill (req-7), Windows crash-recovery watchdog (Blocker J)

Daily commands

freecode                              # TUI
freecode --print "explain this code"  # one-shot
freecode -c                           # resume last session
freecode --agent fast --print "..."   # pick agent (build|plan|general|edit-bot|fast)
freecode keys                         # add provider keys
freecode doctor                       # 7-check health
freecode status                       # runtime state
freecode trust                        # trust current workspace
freecode help                         # full help

Requirements

• Node.js ≥ 20.11.0
• opencode-ai 1.15.10 (auto-installed as a peer)
• At least one free LLM provider key (OpenRouter recommended — no waitlist, no phone)

License

MIT