Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/21st-dev/1code/llms.txt

Use this file to discover all available pages before exploring further.

Welcome to 1Code

Run Claude Code, Codex, and more in one powerful desktop app. Work with AI agents locally or in the cloud, with git worktree isolation and real-time previews.

Get StartedAPI Reference

Get Started in Minutes

Set up 1Code and run your first AI coding agent in just a few steps

1

Install 1Code

Download the desktop app from 1code.dev or build from source:
git clone https://github.com/21st-dev/1code
cd 1code
bun install
bun run claude:download
bun run codex:download
bun run build
bun run package:mac
2

Create your first project

Open 1Code and create a new project by selecting a local folder. Each project can have multiple chat sessions with different agents.
1Code uses git worktrees to isolate each chat session, keeping your main branch clean and safe.
3

Start a chat with an agent

Choose between Claude Code or Codex, then start chatting. The agent can read files, execute commands, make edits, and more - all visible in real-time in the UI.
# Example: Ask the agent to add a new feature
"Add user authentication with JWT tokens"
4

Review and merge changes

See diff previews of all changes, review the agent’s work, and merge to your main branch using the built-in git client.

Powerful Features

Everything you need to work effectively with AI coding agents

Multi-Agent Support

Switch between Claude Code, Codex, and custom models instantly

Visual UI

See diff previews, git activity, and tool execution in real-time

Worktree Isolation

Each chat runs in its own git worktree - never touch main

Background Agents

Run agents in cloud sandboxes that keep working when you close your laptop

Plan Mode

Review structured plans before execution with clarifying questions

MCP Integration

Connect to MCP servers and browse the plugin marketplace

Explore by Topic

Learn how to use 1Code for your workflow

Working with Worktrees

Understand how 1Code uses git worktrees to isolate your work

Setting Up MCP Servers

Connect external tools and services via Model Context Protocol

Automations

Trigger agents from GitHub, Linear, or Slack automatically

Git Integration

Use the built-in git client to stage, commit, and push changes

Ready to Get Started?

Download 1Code and start working with AI coding agents today

Get StartedView on GitHub

Community & Support

Join Discord

Get help, share feedback, and connect with the community

GitHub Discussions

Ask questions and discuss feature requests