1Code (Auto-Build Fork)

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.

Why This Fork?

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

Feature	Official Repo	This Fork
Auto-sync with upstream	❌	✅ On upstream commits
Auto-build on upstream release tags	❌	✅ GitHub Actions
Auto-update in app	❌ CDN only	✅ From your fork's releases
Manual builds needed	✅ Every update	❌ Never

Quick Start

1. Fork this repo

Click the Fork button above to create your own copy.

2. Enable GitHub Actions

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)

3. Trigger the first build

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

4. Install and configure

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"
}

How It Works

┌─────────────────────┐
│  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)
└─────────────────────┘

Workflows

Workflow	Trigger	Purpose
sync-fork.yml	Every 6 hours	Syncs upstream main; triggers release build only when upstream tag changes
build-release.yml	Manual or from sync-fork.yml	Builds app and creates GitHub Release

Version Tracking

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.

Customization

Change release check frequency

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

Enable Windows/Linux builds

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

build-windows:
  if: true  # Change from false

build-linux:
  if: true  # Change from false

Revert to official updates

bun run setup:fork --cdn

Notes

• 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.

---

Original 1Code Features

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.

1Code vs Claude Code

Feature	1Code	Claude Code
Visual UI	✅ Cursor-like desktop app	✅
Git Worktree Isolation	✅ Each chat runs in isolated worktree	✅
Background Execution	✅ Run multiple agents in parallel	✅
Built-in Git Client	✅ Visual staging, commits, branches	❌ CLI git commands only
Integrated Terminal	✅	❌
Plan Mode	✅	✅
MCP Support	✅	✅
Memory (CLAUDE.md)	✅	✅
Skills & Slash Commands	✅	✅
Custom Subagents	✅	✅
Subscription & API Key Support	✅	✅
Custom Models & Providers (BYOK)	✅	✅
Voice Input	✅ Hold-to-talk dictation	❌
Checkpointing	🚧 Beta	✅
Tool Approve	📋 Backlog	✅
Hooks	❌	✅

Features

Run Claude agents the right way

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

UI that finally respects your code

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

Plan mode that actually helps you think

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

More Features

• 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

Manual Build (if needed)

bun install
bun run claude:download
bun run build
bun run package:mac  # or package:win, package:linux

Development

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

Community

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

License

Apache License 2.0 - see LICENSE for details.