This is a community fork of 21st-dev/1code with automatic sync and build capabilities.

Fork this repo to get automatic sync whenever upstream main changes, and automatic releases on upstream release tags — no manual rebuilding required.

The official 1Code repo requires you to manually build the app every time there's an update. This fork solves that:

Click the Fork button above to create your own copy.

In your fork:

1. Go to Settings → Actions → General
2. Select "Allow all actions and reusable workflows"
3. Under "Workflow permissions", select "Read and write permissions"
4. Click Save
5. If your main branch is protected, allow GitHub Actions to bypass it or disable "Require a pull request before merging" for this fork (auto-sync pushes directly to main)

1. Go to Actions tab
2. Click "Build and Release" workflow
3. Click Run workflow → Run workflow

Wait for the build to complete (~10-15 min). Your release will appear at:

https://github.com/YOUR_USERNAME/1code/releases

Download the DMG from your releases and install. Then configure the app to check your fork for updates:

# Clone your fork
git clone https://github.com/YOUR_USERNAME/1code.git
cd 1code
bun install

# Configure auto-updates from your fork
bun run setup:fork YOUR_USERNAME

Or manually create ~/Library/Application Support/1Code/update-config.json:

{
  "source": "github",
  "githubRepo": "YOUR_USERNAME/1code"
}

┌─────────────────────┐
│  21st-dev/1code     │ (upstream)
│  pushes new commits │
└──────────┬──────────┘
           │ checked every 6 hours
           ▼
┌─────────────────────┐
│ New upstream commits│
│      to sync?       │
└──────────┬──────────┘
           │ yes → sync
           ▼
┌─────────────────────┐
│  Your fork          │ (auto-synced)
│  merges changes     │
└──────────┬──────────┘
           │ upstream release tag changed?
           ▼
┌─────────────────────┐
│  GitHub Actions     │
│  builds on new tag  │
└──────────┬──────────┘
           │ creates release
           ▼
┌─────────────────────┐
│  Your local app     │
│  shows "Update"     │ (on window focus)
└─────────────────────┘

The file .last-synced-version tracks the latest upstream main commit SHA that was synced. The file .last-released-upstream-tag tracks the latest upstream release tag already built in your fork.

Edit .github/workflows/sync-fork.yml:

schedule:
  - cron: "0 */6 * * *"  # Every 6 hours (default)
  - cron: "0 */12 * * *" # Every 12 hours
  - cron: "0 0 * * *"    # Once daily

Edit .github/workflows/build-release.yml:

build-windows:
  if: true  # Change from false

build-linux:
  if: true  # Change from false

bun run setup:fork --cdn

• Unsigned builds: These builds aren't code-signed. macOS will show a warning or "damaged" message.

  Fix for "damaged" error:

  xattr -cr /Applications/1Code.app

  This removes the quarantine attribute. Then open the app normally.

• Claude binary: The build downloads Claude CLI automatically. If it fails, agent chat won't work but the app will still build.

1Code.dev — Best UI for Claude Code with local and remote agent execution.

By 21st.dev team

Platforms: macOS, Linux, and Windows. Windows support improved thanks to community contributions.

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

• Git Worktree Isolation - Each chat session runs in its own isolated worktree
• Background Execution - Run agents in background while you continue working
• Local-first - All code stays on your machine, no cloud sync required
• Branch Safety - Never accidentally commit to main branch

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

• Diff Previews - See exactly what changes Claude is making in real-time
• Built-in Git Client - Stage, commit, and manage branches without leaving the app
• Change Tracking - Visual diffs and PR management
• Real-time Tool Execution - See bash commands, file edits, and web searches as they happen

Claude asks clarifying questions, builds structured plans, and shows clean markdown preview — all before execution.

• Clarifying Questions - Claude asks what it needs to know before starting
• Structured Plans - See step-by-step breakdown of what will happen
• Clean Markdown Preview - Review plans in readable format
• Review Before Execution - Approve or modify the plan before Claude acts

• Plan & Agent Modes - Read-only analysis or full code execution permissions
• Project Management - Link local folders with automatic Git remote detection
• Integrated Terminal - Full terminal access within the app

bun install
bun run claude:download
bun run codex:download
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).

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

• Discord for support and discussions
• Original repo for upstream issues

Apache License 2.0 - see LICENSE for details.