Experimental self-hosted AI coding agent, forked from opencode.
Warning
Codeplane is a personal experimental fork of sst/opencode, used under the upstream MIT license. It is not affiliated with Anomaly. Use upstream opencode if you need the stable project; use Codeplane if you want this fork's UI, mobile, packaging, and self-hosting experiments.
Codeplane is one self-hosted server with multiple clients:
- Terminal TUI for SSH and keyboard-first work.
- Web UI served by the Codeplane server.
- Electron desktop shell for macOS, Windows, and Linux.
- Native mobile shell for following sessions from a phone.
The server owns sessions, permissions, tools, provider auth, MCP connections, config, and SQLite state. Every client attaches to the same server, so a session started in the terminal can be continued from the desktop app or mobile shell.
curl -fsSL https://codeplane.cc/install | bashAlternative paths:
npm install -g codeplane-ai
bun install -g codeplane-aiThen verify:
codeplane --version
codeplane web --port 4096Full platform matrix, desktop downloads, mobile status, uninstall steps, and directory layout are documented at codeplane.cc/docs/install.
- Bring your own provider: Anthropic, OpenAI, OpenRouter, local OpenAI-compatible endpoints, Ollama/vLLM-style servers, and provider hooks.
- MCP support for local stdio and remote servers.
- Permission rules for edits, bash, web access, MCP/plugin tools, external directories, questions, and more.
- Saved instances for local runtimes, remote servers, auth headers, and daemonized background servers.
- Persistent sessions with branches, queued follow-ups, revert, todos, compaction, and SSE live updates.
- Plugin SDK for tools, auth hooks, provider hooks, chat transforms, permission hooks, shell env, and workspace adapters.
- Release artifacts for CLI npm packages, desktop installers, mobile bundles, SDK, and the static docs site.
- Quick start - install, configure one provider, launch the first server, send a message, save an instance.
- Configuration -
codeplane.jsonc, provider config, agents, permissions, MCP, plugins, commands, runtime behavior. - Providers - model catalog, API keys, OAuth flows, custom OpenAI-compatible endpoints.
- CLI reference -
serve,web,tui,instance,upgrade, completions, environment variables. - Instances - remote URLs, Basic Auth headers, managed local runtimes, daemons.
- HTTP API and TypeScript SDK - raw endpoints and generated client usage.
- MCP and Plugins - extension points.
- Self-hosting - systemd, Docker, reverse proxies, auth, backups.
- Architecture - package map, server route groups, persistence, release outputs.
- Release process - version sync, validation, GitHub release workflows.
- Troubleshooting - common install, server, auth, MCP, desktop/mobile, and release failures.
packages/codeplane CLI, server, TUI host, sessions, tools, providers
packages/app SolidJS web app served by the server
packages/desktop Electron desktop shell and updater integration
packages/mobile Native mobile shell packaging
packages/shared Home paths, instance store, local runtime cache
packages/sdk/js Generated TypeScript SDK
packages/plugin Plugin authoring SDK
packages/ui Shared UI components and theme system
site Next.js source for codeplane.cc
docs Public site compatibility files (CNAME, install script, schemas, legacy home)
Requirements:
- Bun from the root
packageManagerfield. - Git, ripgrep, and platform build tools for native packages.
Install and run:
bun install
bun dev:serverUseful checks:
bun turbo typecheck
bun lint
bun --cwd packages/codeplane test
bun --cwd site typecheck
bun --cwd site buildRoot bun test intentionally fails. Run tests from package directories.
MIT. Codeplane is a fork of sst/opencode, used under that project's MIT license. The fork keeps the same core idea - one runtime, multiple clients - while experimenting with Codeplane-specific UI, mobile, docs, packaging, and release workflows.