conductor

Conductor

Terminal-based Git workspace and code review TUI written in Rust. Manages multiple git worktrees, launches Claude Code sessions via embedded PTYs, reviews diffs, and provides structured inline review comments — designed for an AI-assisted development workflow.

Prerequisites

Required

Dependency	Version	Notes
Rust toolchain	1.85+	Edition 2024. Install via rustup
Git	2.x	Used for worktree operations (git worktree add, git fetch, etc.)
Claude Code	latest	claude CLI must be in $PATH. Install via npm install -g @anthropic-ai/claude-code
Node.js + npm	20+	Required for Claude Code installation and MCP server build

Optional

Dependency	Purpose	How to enable
ccusage (via npx)	Token usage / cost display in title bar	Set ccusage.enabled = true in config

Installation

1. Install the binary

git clone https://github.com/S-Nakamur-a/conductor.git
cd conductor
make install

make install installs the conductor binary to ~/.cargo/bin/ (cargo install --path .) and installs MCP server dependencies (npm install).

2. Install the Claude Code plugin

In a Claude Code session, run:

/plugin marketplace add S-Nakamur-a/conductor
/plugin install conductor@conductor-marketplace

This sets up:

• MCP server — review comment DB integration
• Hooks — waiting-state detection for Claude Code sessions
• Commands — /address-conductor-comment for resolving review comments

Usage

# Run against the current directory
conductor

# Run against a specific repo
conductor /path/to/repo

# Or use make for development
make dev

Layout

Worktree | Explorer | Viewer | Terminal (Claude Code / Shell)

Keybindings

• Tab — cycle focus between panels
• j/k — navigate up/down
• h/l — collapse/expand
• g/G — jump to top/bottom
• / — search
• ? — show help
• Esc — back / close overlay

Command Palette

Ctrl+. (any panel, including terminal) or : (non-terminal panels) to open the command palette. All available commands are listed and fuzzy-searchable — worktree operations, terminal management, diff toggles, review comments, etc.

MCP Server

Conductor includes an MCP server (plugins/conductor/mcp/conductor-comment/) that exposes the review database to Claude Code sessions running inside the terminal. This enables Claude Code to read and write review comments directly.

The MCP server is automatically configured when you install the Claude Code plugin (see Installation step 2).

For development:

cd plugins/conductor/mcp/conductor-comment
npm install
npm run build  # compile TypeScript
npm start      # run compiled JS
# or: npm run dev (runs via tsx, no build step needed)

Configuration

Config file: ~/.config/conductor/config.toml

All fields are optional with sensible defaults. Full example:

[general]
# repo = "/path/to/default/repo"       # default repository to open on startup
main_branch = "main"                    # main/trunk branch name (default: "main")
# shell = "/bin/zsh"                    # shell for PTY sessions (default: $SHELL)
# repos = ["/path/to/repo1", "/path/to/repo2"]  # additional repos for multi-repo support
# worktree_dir = "~/worktrees"          # custom worktree base directory
                                        #   (default: <repo-parent>/<repo-name>-worktrees/)
decoration = "aquarium"                 # worktree panel decoration
                                        #   aquarium | space | garden | city | none
# auto_resume = true                    # automatically resume Claude Code sessions on startup

[terminal]
# inactive_scrollback = 1000            # scrollback lines for background sessions
# active_scrollback = 10000             # scrollback lines for foreground session

[viewer]
theme = "catppuccin-mocha"              # syntax highlighting theme
                                        #   catppuccin-mocha | dracula | nord | solarized-dark
# syntax_theme_file = "~/.config/conductor/custom.tmTheme"  # custom .tmTheme file path
# tab_width = 2                         # spaces per tab stop
# word_wrap = false                     # soft-wrap long lines (未実装)

[diff]
# default_view = "unified"              # unified | side-by-side
# word_diff = true                      # highlight intra-line word changes

[review]
# レビュー機能はMCPプラグイン (conductor plugin) に移行済みです。
# 以下の設定は互換性のため残されていますが、通常は変更不要です。
# prompt_template = "以下のレビューコメントに対応してください。\n\n{comments}"
                                        # template for review prompts ({comments} is replaced)
# prompt_action = "clipboard"           # clipboard | send_to_session