README.md
https://github.com/user-attachments/assets/6bceea0f-60b6-4c3e-a745-b891de00b8d0
[!TIP] โญ Star the repo and follow @getAsterisk on X for early access to
asteria-swe-v0.
[!NOTE] This project is not affiliated with, endorsed by, or sponsored by Anthropic. Claude is a trademark of Anthropic, PBC. This is an independent developer project using Claude.
opcode is a powerful desktop application that transforms how you interact with Claude Code. Built with Tauri 2, it provides a beautiful GUI for managing your Claude Code sessions, creating custom agents, tracking usage, and much more.
Think of opcode as your command center for Claude Code - bridging the gap between the command-line tool and a visual experience that makes AI-assisted development more intuitive and productive.
~/.claude/projects/~/.claude directoryProjects โ Select Project โ View Sessions โ Resume or Start New
CC Agents โ Create Agent โ Configure โ Execute
Menu โ Usage Dashboard โ View Analytics
Menu โ MCP Manager โ Add Server โ Configure
Before building opcode from source, ensure you have the following installed:
Rust (1.70.0 or later)
# Install via rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Bun (latest version)
# Install bun
curl -fsSL https://bun.sh/install | bash
Git
# Usually pre-installed, but if not:
# Ubuntu/Debian: sudo apt install git
# macOS: brew install git
# Windows: Download from https://git-scm.com
Claude Code CLI
claude is available in your PATHLinux (Ubuntu/Debian)
# Install system dependencies
sudo apt update
sudo apt install -y \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
patchelf \
build-essential \
curl \
wget \
file \
libssl-dev \
libxdo-dev \
libsoup-3.0-dev \
libjavascriptcoregtk-4.1-dev
macOS
# Install Xcode Command Line Tools
xcode-select --install
# Install additional dependencies via Homebrew (optional)
brew install pkg-config
Windows
Clone the Repository
git clone https://github.com/getAsterisk/opcode.git
cd opcode
Install Frontend Dependencies
bun install
Build the Application
For Development (with hot reload)
bun run tauri dev
For Production Build
# Build the application
bun run tauri build
# The built executable will be in:
# - Linux: src-tauri/target/release/
# - macOS: src-tauri/target/release/
# - Windows: src-tauri/target/release/
Platform-Specific Build Options
Debug Build (faster compilation, larger binary)
bun run tauri build --debug
Universal Binary for macOS (Intel + Apple Silicon)
bun run tauri build --target universal-apple-darwin
"cargo not found" error
~/.cargo/bin is in your PATHsource ~/.cargo/env or restart your terminalLinux: "webkit2gtk not found" error
libwebkit2gtk-4.0-devWindows: "MSVC not found" error
"claude command not found" error
claude --versionBuild fails with "out of memory"
cargo build -j 2After building, you can verify the application works:
# Run the built executable directly
# Linux/macOS
./src-tauri/target/release/opcode
# Windows
./src-tauri/target/release/opcode.exe
The build process creates several artifacts:
tauri build):
.deb package (Linux).AppImage (Linux).dmg installer (macOS).msi installer (Windows).exe installer (Windows)All artifacts are located in src-tauri/target/release/.
opcode/
โโโ src/ # React frontend
โ โโโ components/ # UI components
โ โโโ lib/ # API client & utilities
โ โโโ assets/ # Static assets
โโโ src-tauri/ # Rust backend
โ โโโ src/
โ โ โโโ commands/ # Tauri command handlers
โ โ โโโ checkpoint/ # Timeline management
โ โ โโโ process/ # Process management
โ โโโ tests/ # Rust test suite
โโโ public/ # Public assets
# Start development server
bun run tauri dev
# Run frontend only
bun run dev
# Type checking
bunx tsc --noEmit
# Run Rust tests
cd src-tauri && cargo test
# Format code
cd src-tauri && cargo fmt
opcode prioritizes your privacy and security:
We welcome contributions! Please see our Contributing Guide for details.
This project is licensed under the AGPL License - see the LICENSE file for details.