opcode

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

• 🌟 Overview
• ✨ Features

  • 🗂️ Project & Session Management

  • 🤖 CC Agents

  • 📊 Usage Analytics Dashboard

  • 🔌 MCP Server Management

  • ⏰ Timeline & Checkpoints

  • 📝 CLAUDE.md Management

• 📖 Usage
  • Getting Started
  • Managing Projects
  • Creating Agents
  • Tracking Usage
  • Working with MCP Servers
• 🚀 Installation
• 🔨 Build from Source
• 🛠️ Development
• 🔒 Security
• 🤝 Contributing
• 📄 License
• 🙏 Acknowledgments

✨ 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

• Claude Code CLI: Install from Claude's official site

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
   

This is the beginning of the README. Read the rest at the original. Read the full README ↗