opcode README

The project's README from github.com/winfunc/opcode. As one markdown file: README.md.

opcode Logo

opcode

A powerful GUI app and Toolkit for Claude Code

Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.

Features Installation Usage Development Discord

457013521-6133a738-d0cb-4d3e-8746-c6768c82672c

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.

🌟 Overview

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.

📋 Table of Contents

✨ Features

🗂️ Project & Session Management

🤖 CC Agents

📊 Usage Analytics Dashboard

🔌 MCP Server Management

⏰ Timeline & Checkpoints

📝 CLAUDE.md Management

📖 Usage

Getting Started

  1. Launch opcode: Open the application after installation
  2. Welcome Screen: Choose between CC Agents or Projects
  3. First Time Setup: opcode will automatically detect your ~/.claude directory

Managing Projects

Projects → Select Project → View Sessions → Resume or Start New

Creating Agents

CC Agents → Create Agent → Configure → Execute
  1. Design Your Agent: Set name, icon, and system prompt
  2. Configure Model: Choose between available Claude models
  3. Set Permissions: Configure file read/write and network access
  4. Execute Tasks: Run your agent on any project

Tracking Usage

Menu → Usage Dashboard → View Analytics

Working with MCP Servers

Menu → MCP Manager → Add Server → Configure

🚀 Installation

Prerequisites

Release Executables Will Be Published Soon

🔨 Build from Source

Prerequisites

Before building opcode from source, ensure you have the following installed:

System Requirements

Required Tools

  1. Rust (1.70.0 or later)

    # Install via rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  2. Bun (latest version)

    # Install bun
curl -fsSL https://bun.sh/install | bash

  3. Git

    # Usually pre-installed, but if not:
# Ubuntu/Debian: sudo apt install git
# macOS: brew install git
# Windows: Download from https://git-scm.com

  4. Claude Code CLI

Platform-Specific Dependencies

Linux (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

Build Steps

  1. Clone the Repository

    git clone https://github.com/getAsterisk/opcode.git
cd opcode

  2. Install Frontend Dependencies

    bun install

  3. 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/

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

Troubleshooting

Common Issues

  1. "cargo not found" error

    • Ensure Rust is installed and ~/.cargo/bin is in your PATH
    • Run source ~/.cargo/env or restart your terminal

  2. Linux: "webkit2gtk not found" error

    • Install the webkit2gtk development packages listed above
    • On newer Ubuntu versions, you might need libwebkit2gtk-4.0-dev

  3. Windows: "MSVC not found" error

    • Install Visual Studio Build Tools with C++ support
    • Restart your terminal after installation

  4. "claude command not found" error

    • Ensure Claude Code CLI is installed and in your PATH
    • Test with claude --version

  5. Build fails with "out of memory"

    • Try building with fewer parallel jobs: cargo build -j 2
    • Close other applications to free up RAM

Verify Your Build

After 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

Build Artifacts

The build process creates several artifacts:

All artifacts are located in src-tauri/target/release/.

🛠️ Development

Tech Stack

Project Structure

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

Development Commands

# 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

🔒 Security

opcode prioritizes your privacy and security:

  1. Process Isolation: Agents run in separate processes
  2. Permission Control: Configure file and network access per agent
  3. Local Storage: All data stays on your machine
  4. No Telemetry: No data collection or tracking
  5. Open Source: Full transparency through open source code

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Areas for Contribution

📄 License

This project is licensed under the AGPL License - see the LICENSE file for details.

🙏 Acknowledgments

Made with ❤️ by the Asterisk

Report Bug · Request Feature

Star History

Star History Chart

opcode (winfunc/opcode)

Searching Database…

22.4K ·GitHub
Opcode
Что это такое?opcode — неофициальное настольное приложение с графическим интерфейсом и набор инструментов для Claude Code: оно позволяет управлять сессиями кодинга, пользовательскими агентами, расходами, серверами MCP и файлами CLAUDE.md из одного визуального интерфейса вместо терминала.
Это отдельное настольное приложение или то, что работает внутри терминала?Это самостоятельное настольное приложение: Tauri 2 с бэкендом на Rust и интерфейсом на React 18 + TypeScript. Оно связывает CLI Claude Code с визуальным интерфейсом и при первом запуске автоматически находит вашу существующую папку ~/.claude.
Как его запустить?Готовых установщиков пока нет, так что сейчас придётся собирать из исходников: клонируйте репозиторий, установите зависимости фронтенда через Bun, затем выполните сборку — на выходе получите .dmg, .msi/.exe, .deb или .AppImage.
Что нужно установить, прежде чем собирать проект?CLI Claude Code должен быть уже установлен и прописан в PATH — opcode является лишь визуальной надстройкой над ним. Для компиляции самого приложения также нужны Rust 1.70+, Bun и Git.
Есть ли подводные камни при сборке?Есть пара особенностей платформ: на Linux нужны dev-пакеты webkit2gtk, на Windows — MSVC Build Tools (плюс WebView2), а на машинах с малым объёмом памяти может понадобиться cargo build -j 2, чтобы избежать сбоев из-за нехватки памяти.
Он запустится на моём Windows-компьютере или это только для Mac?Работает на Windows 10/11, macOS 11+ и Linux (Ubuntu 20.04+). Под macOS можно собрать универсальный бинарник, подходящий и для Intel, и для Apple Silicon.
Всё, что я в нём делаю, остаётся на моём компьютере?Да: все данные хранятся локально, телеметрии и отслеживания нет, а агенты запускаются в отдельных процессах с настраиваемыми вами правами доступа к файлам и сети для каждого агента.
Что умеют пользовательские CC-агенты?Вы создаёте агента с именем, иконкой и системным промптом, выбираете модель Claude и задаёте права на чтение/запись файлов и доступ к сети. Агенты работают в фоне как отдельные процессы, и каждый запуск логируется с подробными метриками производительности.
Можно ли увидеть, сколько я трачу на Claude?Да — панель использования отслеживает расходы на API в реальном времени, разбивает токены по моделям, проектам и периодам времени, а данные можно экспортировать для бухгалтерии. Графики показывают тенденции вашего использования.
Можно ли откатить сессию кодинга на более ранний момент?Да. Вы можете создавать контрольные точки в любом месте сессии, просматривать их на ветвящейся шкале времени, восстанавливать любую точку одним кликом, создавать из них новые ветки и смотреть diff изменений между ними.
Он помогает управлять серверами MCP?Есть единый реестр серверов Model Context Protocol: добавляйте их через интерфейс или в виде JSON, импортируйте конфиги из Claude Desktop и проверяйте каждое подключение перед использованием.
What are similar projects?casbin-gateway, claudecodeui, ThinkWatch-Lite, void, ai-manager, zuse, laya, skills-manager
Which topics is it in?anthropic-claude, claude-ai, cost-tracking, ide, tauri, tailwindcss, agpl, cursor, sqlite, anthropic, coding-agent, desktop
Creator
winfunc
Size
3.2 MB
Stars
22.4K
Updated
CommitSep 18Releasev0.2.0Aug 31
Age
1y
Commits · 90 Days