1code README

The project's README from github.com/21st-dev/1code. As one markdown file: README.md.

1Code

1Code.dev

Open-source coding agent client. Run Claude Code, Codex, and more - locally or in the cloud.

By 21st.dev team

Highlights

Features

Run coding agents the right way

Run agents locally, in worktrees, in background - without touching main branch.

Worktree Demo


UI that finally respects your code

Cursor-like UI with diff previews, built-in git client, and the ability to see changes before they land.

Cursor UI Demo


Plan mode that actually helps you think

The agent asks clarifying questions, builds structured plans, and shows clean markdown preview - all before execution.

Plan Mode Demo


Background agents that never sleep

Close your laptop. Your agents keep running in isolated cloud sandboxes with live browser previews.


Connect anything with MCP

Full MCP server lifecycle management with a built-in plugin marketplace. No config files needed.


Automations that work while you sleep

Trigger agents from GitHub, Linear, Slack, or manually from git events. Auto-review PRs, fix CI failures, and complete tasks - all configurable.

Automations require a Pro or Max subscription. Learn more at 1code.dev/agents/async.

API

Run coding agents programmatically. Point at a repo, give it a task - the agent runs in a sandbox and delivers a PR.

curl -X POST https://1code.dev/api/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "repository": "https://github.com/your-org/your-repo",
    "prompt": "Fix the failing CI tests"
  }'

Learn more at 1code.dev/agents/api

Installation

Option 1: Build from source (free)

# Prerequisites: Bun, Python 3.11, setuptools, Xcode Command Line Tools (macOS)
bun install
bun run claude:download  # Download Claude binary (required!)
bun run codex:download   # Download Codex binary (required!)
bun run build
bun run package:mac  # or package:win, package:linux

Important: The claude:download and codex:download steps download required agent binaries. If you skip them, the app may build but agent functionality will not work correctly.

Python note: Python 3.11 is recommended for native module rebuilds. On Python 3.12+, make sure setuptools is installed (pip install setuptools).

Get pre-built releases + background agents support by subscribing at 1code.dev.

Your subscription helps us maintain and improve 1Code.

Development

bun install
bun run claude:download  # First time only
bun run codex:download   # First time only
bun run dev

Feedback & Community

Join our Discord for support and discussions.

License

Apache License 2.0 - see LICENSE for details.

1code (21st-dev/1code)

Searching Database…

5.6K ·GitHub
archived
What is this?1Code is an open-source desktop client that lets you run coding agents like Claude Code and Codex locally or in the cloud, all from one Cursor-style interface.
Is this a coding agent itself or an app that manages other agents?It is an orchestration layer and desktop app that wraps existing coding agents (Claude Code, Codex) with a Cursor-like UI, built-in git client and terminal — it does not run its own model.
How do I get it running?Build it from source for free, running the claude:download and codex:download steps to pull agent binaries, or subscribe at 1code.dev to get pre-built releases plus background agent support.
Do I need to grab agent binaries separately before it works?Yes — the claude:download and codex:download build steps fetch the required agent binaries; skipping them lets the app build but agent functionality won't work. Python 3.11 is recommended for native module rebuilds.
Is automation across GitHub, Linear and Slack free to use?No — triggering agents from GitHub, Linear, or Slack and other async automations require a paid Pro or Max subscription; building from source only gets you the local app.
Which platforms does it actually run on?1Code ships as a macOS desktop app and a web app, and also supports Windows and Linux builds.
Does my code get sent anywhere by default?No — in local mode everything stays on your machine with no required cloud sync; cloud sandboxes are only used for background agents you explicitly trigger.
What is BYOK support for?1Code lets you bring your own API keys for custom models and providers instead of being locked into one vendor.
How do background agents keep working after I close my laptop?They run in isolated cloud sandboxes rather than on your machine, so they keep going even when your laptop sleeps, and you can watch a live browser preview of the dev branch.
Can I trigger agents without opening the app?Yes — tagging @1code in GitHub, Linear, or Slack, or firing it on a git event like a push or PR, can start an agent session automatically.
Can I run agents without the desktop UI at all?Yes, there's an API: point it at a repo and a task, and the agent runs in a remote sandbox and opens a PR for you.
Creator
21st-dev
Size
16.1 MB
Stars
5.6K
Age
9mo
Commits · 90 Days