Multicode

A terminal UI for managing multiple Git repositories with integrated Claude Code support. Work on several projects simultaneously, each with its own Claude Code session, git worktrees, and persistent conversation history.

Features

• Multi-Project Tabs - Open multiple repositories as tabs, switch instantly with 1-9 keys
• Embedded Claude Code - Full Claude Code terminal per project with session persistence
• Git Worktree Management - Create, switch, and manage worktrees without leaving the app
• Session Resume - Claude conversations persist across restarts via --resume
• Activity Indicators - See which tab has active Claude thinking/tool execution
• Script Runner - Quick access to dev and build scripts per project

Installation

Quick Start (Recommended)

bunx multicode

That's it! Requires Bun to be installed.

Install Globally

bun install -g multicode
multicode

From Source

git clone https://github.com/twdnhfr/multicode.git
cd multicode
bun install
bun run dev

First Run

On first launch, press Ctrl+S to open setup:

1. Set your repository folder (e.g., ~/projects)
2. Set your worktree base path (where new worktrees are created)
3. Claude CLI path is auto-detected

Keyboard Shortcuts

Global

| Key | Action | |-----|--------| | Ctrl+O | Open repository picker | | Ctrl+S | Open setup | | Ctrl+Q | Quit | | Tab | Cycle focus between areas | | 1-9 | Switch to tab/worktree by number |

When focused on Tabs

| Key | Action | |-----|--------| | x | Close current tab | | c | Open Claude Code |

When focused on Worktrees

| Key | Action | |-----|--------| | w | Open worktree manager |

When focused on File Tree

| Key | Action | |-----|--------| | ↑/↓ | Navigate | | Enter | Expand/collapse folder | | Ctrl+F | File search | | . | Toggle hidden files |

When focused on Terminal

| Key | Action | |-----|--------| | Escape | Return focus to file tree |

Layout

┌─[1:project-a]─[2:project-b]─[3:project-c]────────────────────────┐
├─[1:main↑0↓0]─[2:feature-x↑2↓0]───────────────────────────────────┤
│ 📁 project-a    │                                                │
│ ├── src/        │   Claude Code Terminal                         │
│ ├── tests/      │                                                │
│ └── ...         │   > How can I help you today?                  │
│                 │                                                │
├─────────────────┴────────────────────────────────────────────────┤
│ [t] OTLP:4319 │ Scripts: [d] dev [b] build                       │
└──────────────────────────────────────────────────────────────────┘

Session Persistence

Multicode automatically saves and restores:

• Open tabs and their repositories
• Active worktree per tab
• Claude session IDs for conversation resume
• Last active tab

Sessions are stored in ~/.multicoderc.

How It Works

Claude Integration

Each tab maintains its own Claude session ID. When you open Claude Code:

• First time: Creates new session with --session-id
• Subsequent opens: Resumes with --resume
• If session expired: Automatically creates new session

OTLP Telemetry

Multicode runs an OTLP receiver on port 4319 to receive telemetry from Claude Code. This enables:

• Real-time activity indicators (⚡ for tools, ◉ for thinking)
• Session ID matching to show status on correct tab

Git Worktrees

Create isolated worktrees for parallel development:

1. Focus worktree bar and press w
2. Enter branch name
3. New worktree is created and switched to

Each worktree shows sync status (↑ahead ↓behind).

Requirements

• Bun runtime
• Claude Code CLI installed
• Git

Configuration

Config file: ~/.multicoderc

{
  "repoDirectory": "/Users/you/projects",
  "claudePath": "/usr/local/bin/claude",
  "worktreeBasePath": "/Users/you/worktrees",
  "openTabs": [...],
  "activeTabIndex": 0
}

Contributing

This project is open source and we'd love your help! Whether it's:

• 🐛 Reporting bugs
• 💡 Suggesting new features
• 🔧 Submitting pull requests
• 📖 Improving documentation

Feel free to open an issue or submit a PR. All contributions are welcome!

License

MIT