opcode is a free, open source ides & code editors project written in TypeScript and released under AGPL-3.0. It has 22,408 GitHub stars, 1,720 forks and 332 open issues, and was last pushed 14 hours ago. On this registry it ranks #10 of 14 tracked projects in IDEs & Code Editors, with 5 head-to-head comparisons available.

What is opcode?

opcode is an open-source desktop GUI application and toolkit for Claude Code that provides a visual command centre for projects, sessions, custom agents, Model Context Protocol servers, checkpoints, and API usage, aimed at developers who already work with Claude Code from the command line and want a graphical layer over it.

What it is

opcode is a desktop application built with Tauri 2 and written in TypeScript, distributed under the AGPL-3.0 licence. It reads the Claude Code data already on a machine, including the projects stored under ~/.claude/projects/, and presents that material through a graphical interface rather than a terminal. The project is an independent developer effort and is not affiliated with, endorsed by, or sponsored by Anthropic; Claude is a trademark of Anthropic, PBC. It sits in the Developer Tools / IDEs & Code Editors category of this registry, with its homepage at https://opcode.sh.

The concrete problem it solves is the gap between the Claude Code command-line tool and a visual experience. Without such a layer, a developer who wants to revisit a past coding session, compare two points in that session's history, inspect what a custom agent was told to do, or understand what a month of API usage cost has to assemble that picture by hand. opcode replaces that manual, terminal-bound workflow with a single application: a project browser, a resumeable session list, a checkpoint timeline, an agent library with execution logs, and a usage dashboard with cost and token analytics.

Key capabilities

  • Visual project browser that navigates every Claude Code project stored in ~/.claude/projects/, with built-in search and session metadata such as first messages and timestamps.
  • CC Agents: custom agents with their own system prompts and behaviours, an agent library, background execution in separate processes for non-blocking work, and execution history with logs and performance metrics.
  • Usage analytics dashboard covering cost tracking, token breakdowns by model, project, and time period, visual charts, and export of usage data for accounting and analysis.
  • MCP server registry for Model Context Protocol servers, with addition through the UI or import from existing configurations, connection testing before use, and import of server configurations from Claude Desktop.
  • Timeline and checkpoints: session versioning, a branching visual timeline, one-click restore, session forking from an existing checkpoint, and a diff viewer showing exactly what changed between checkpoints.
  • CLAUDE.md management through a built-in editor with live markdown preview, a project scanner that finds every CLAUDE.md file across projects, and syntax highlighting.

Who uses it and how

  • Individual developers who have accumulated many Claude Code projects under ~/.claude/projects/ and need to find, reopen, and resume past sessions without remembering directory names.
  • Teams that must attribute Claude API spend, using token analytics by model, project, and period plus data export for accounting.
  • Users who run long or non-blocking jobs as background CC Agents in separate processes while continuing interactive work.
  • Developers maintaining several MCP servers, who configure and connectivity-test them from one UI instead of editing configuration files by hand.
  • Existing Claude Desktop users who import their MCP server configurations rather than re-entering them.

Getting started

Install opcode as a desktop application from the project site at https://opcode.sh or follow the README's Installation section, with a documented Build from Source path for Tauri 2 development. After launching, the welcome screen offers a choice between CC Agents and Projects.

How it compares

The registry lists Cursor and the Claude Code SDK among related topics, placing opcode in the same neighbourhood as AI-assisted coding tools rather than as a replacement for them. It complements the Claude Code command-line tool and SDK by adding a desktop interface over the same underlying sessions and configuration, so developers who prefer the CLI lose nothing by adopting it and developers who prefer visual workflows gain a place to manage what the CLI produced.

When to use it — and when not to

Choose opcode if a desktop environment is available, Claude Code is already in use, and the value of visual session history, checkpoint restore, agent management, and cost visibility outweighs the overhead of running a GUI application on top of the underlying CLI and API spend. Avoid it for headless, server-only, or CI workflows where no desktop session exists, and note that the AGPL-3.0 licence imposes copyleft obligations that matter if the code is to be embedded in a proprietary product. The project is also unaffiliated with Anthropic, so it carries no vendor support, and the repository currently shows 332 open issues.

project readme (upstream, from github) — read inline

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

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

  • Visual Project Browser: Navigate through all your Claude Code projects in ~/.claude/projects/
  • Session History: View and resume past coding sessions with full context
  • Smart Search: Find projects and sessions quickly with built-in search
  • Session Insights: See first messages, timestamps, and session metadata at a glance

🤖 CC Agents

  • Custom AI Agents: Create specialized agents with custom system prompts and behaviors
  • Agent Library: Build a collection of purpose-built agents for different tasks
  • Background Execution: Run agents in separate processes for non-blocking operations
  • Execution History: Track all agent runs with detailed logs and performance metrics

📊 Usage Analytics Dashboard

  • Cost Tracking: Monitor your Claude API usage and costs in real-time
  • Token Analytics: Detailed breakdown by model, project, and time period
  • Visual Charts: Beautiful charts showing usage trends and patterns
  • Export Data: Export usage data for accounting and analysis

🔌 MCP Server Management

  • Server Registry: Manage Model Context Protocol servers from a central UI
  • Easy Configuration: Add servers via UI or import from existing configs
  • Connection Testing: Verify server connectivity before use
  • Claude Desktop Import: Import server configurations from Claude Desktop

Timeline & Checkpoints

  • Session Versioning: Create checkpoints at any point in your coding session
  • Visual Timeline: Navigate through your session history with a branching timeline
  • Instant Restore: Jump back to any checkpoint with one click
  • Fork Sessions: Create new branches from existing checkpoints
  • Diff Viewer: See exactly what changed between checkpoints

📝 CLAUDE.md Management

  • Built-in Editor: Edit CLAUDE.md files directly within the app
  • Live Preview: See your markdown rendered in real-time
  • Project Scanner: Find all CLAUDE.md files in your projects
  • Syntax Highlighting: Full markdown support with syntax highlighting

📖 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
  • Click on any project to view its sessions
  • Each session shows the first message and timestamp
  • Resume sessions directly or start new ones

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
  • Monitor costs by model, project, and date
  • Export data for reports
  • Set up usage alerts (coming soon)

Working with MCP Servers

Menu → MCP Manager → Add Server → Configure
  • Add servers manually or via JSON
  • Import from Claude Desktop configuration
  • Test connections before using

🚀 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
  • Operating System: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)
  • RAM: Minimum 4GB (8GB recommended)
  • Storage: At least 1GB free space
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

readme truncated — read the full docs on github

Frequently asked questions

Is opcode free to use?

opcode is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does opcode do?

A powerful GUI app and Toolkit for Claude Code - Create custom agents, manage interactive Claude Code sessions, run secure background agents, and more.

What is opcode written in?

opcode is primarily written in TypeScript. Its source is publicly available at https://github.com/winfunc/opcode, and it has 22,408 GitHub stars.