# Conductor > A Rust terminal UI for AI-assisted development: manage multiple git worktrees, run Claude Code sessions in embedded PTYs, and review diffs with structured inline comments — all from one TUI. - **Type:** MCP server - **Install:** `agentstack add mcp-s-nakamur-a-conductor` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [S-Nakamur-a](https://agentstack.voostack.com/s/s-nakamur-a) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [S-Nakamur-a](https://github.com/S-Nakamur-a) - **Source:** https://github.com/S-Nakamur-a/conductor ## Install ```sh agentstack add mcp-s-nakamur-a-conductor ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # 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](https://rustup.rs/) | | **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 | | **GitHub CLI** (`gh`) | Pulling in a PR for review, and publishing review comments to GitHub | [Install](https://cli.github.com/) and run `gh auth login` | ## Installation ### 1. Install the binary ```sh 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 ci`). ### 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 and AI walkthrough persistence - **Hooks** — waiting-state detection for Claude Code sessions - **Skills** — `/address-conductor-comment` (resolve review comments), `/explain-comment` (annotate hard-to-understand code with inline comments) ## Usage ```sh # Run against the current directory conductor # Run against a specific repo conductor /path/to/repo # Or use make for development make dev ``` ## Layout ``` ┌────────────────────────────────────────────────────────┐ │ Title bar │ ├────────────────────────────────────────────────────────┤ │ Worktree monitor strip (full width) │ ├──────────────┬──────────────┬──────────────────────────┤ │ │ │ Claude Code │ │ Explorer │ Viewer ├──────────────────────────┤ │ (tree + diff)│ (file/diff) │ Shell │ ├──────────────┴──────────────┴──────────────────────────┤ │ Status bar │ └────────────────────────────────────────────────────────┘ ``` The main area is a three-column accordion — **Explorer | Viewer | Terminal** — with focus-driven widths. The worktree list is no longer a column: every worktree (branch, dirty count, ahead/behind, and Claude Code waiting/active state) is shown in the full-width **worktree monitor strip** along the top, so multiple parallel sessions can be watched at a glance. Click a worktree to jump to it, `[+]` to create one, or open the switcher modal for the full list/detail view. - **Explorer** column is split 50/50: file tree (top) and diff / comment list (bottom). - **Terminal** column is split 80/20: Claude Code (top) and Shell (bottom). - Any panel can be maximized (`Ctrl+Alt+Z`) to take the full main area, or resized tmux-style with `Ctrl+Alt+Arrow` (the new ratios persist to `config.toml`). ### Keybindings - **Tab / Shift+Tab** — cycle panel focus (non-terminal panels) - **Alt+h / Alt+l** — cycle panel focus from anywhere, including terminals - **Alt+1…6** (or **⌘+1…6**) — focus a specific panel - **Ctrl+Alt+Z** — maximize / restore (zoom) the focused panel - **Ctrl+Alt+Arrow** — resize the focused panel tmux-style (ratios persist) - **Ctrl+Tab / Ctrl+Shift+Tab** (or **Alt+] / Alt+[**) — switch the selected worktree - **Ctrl+n** — new Claude Code session · **Ctrl+t** — new shell - **j/k** — navigate up/down · **h/l** — collapse/expand · **g/G** — top/bottom - **/** — search · **Ctrl+g** — full-text (grep) search - **?** — show help · **Esc** — back / close overlay · **Ctrl+q** — quit ### Command Palette **Ctrl+p** (any panel, including terminals) or **:** (non-terminal panels) opens the command palette. All available commands are listed and fuzzy-searchable — worktree operations, terminal management, diff toggles, review comments, etc. ## Reviewing a Pull Request PR review is built into the normal Explorer/Viewer/Terminal accordion — there's no separate full-screen mode to enter or exit, so all the usual navigation and terminal keybindings keep working while you review: 1. **Pull Request → local worktree** — palette: *Review: Review Pull Request…*, enter a PR number or URL. Conductor fetches it (via `gh`) into a worktree and focuses the Explorer's changed-files list. 2. **Changed files, comments, and walkthrough** — the Explorer's bottom pane cycles between three views: the changed-files diff list, the review comment list, and (once generated) the AI walkthrough — palette: *Review: Show Walkthrough* to switch to it directly. 3. **Jump into the code** — the diff pane supports the Viewer's `gd`/`gi`/`gr` symbol-jump hints (go to definition / implementation / references). **Symbol jumps only work for Rust, Go, and TypeScript** — other languages show no hints. 4. **AI walkthrough** — palette: *Review: Generate Walkthrough* asks Claude Code to produce an ordered tour of the change (intent → core change → ripple effects → tests). In the walkthrough view, `j`/`k` move the selection, `n`/`N` jump to the next/previous step's location in the diff, `Enter` jumps to the selected step, and `space` opens the full step text in an overlay. A viewed step, or a changed file you've marked with `v`, is greyed out with a ✓ once you've looked at it. 5. **Publish comments** — palette: *Review: Publish Comments to GitHub* posts your inline review comments (and replies) back to the PR via `gh`. Requires the `gh` CLI (see Prerequisites) to be installed and authenticated. > **Breaking change:** diff mode's "jump to top" moved from `g` to `gg` (vim-style), > since `g` is now a prefix for symbol-jump hints (`gd`/`gi`/`gr`/`gg`). ## 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: ```sh 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: ```toml [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: /-worktrees/) decoration = "aquarium" # worktree panel decoration # aquarium | space | garden | city | none # auto_resume = true # automatically resume Claude Code sessions on startup # auto_resume_main = false # also resume the session on the main worktree # (grabbed sessions are always resumed regardless) [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 [keybinds] # Key-bind overrides, in key->action form (powered by keymap-rs). Each entry # maps a key chord to an action name and LAYERS OVER the built-in defaults # per-chord. [keybinds.keys] is the global layer; each [keybinds.layers.] # is a per-panel layer (worktree, explorer, explorer_diff_list, # explorer_comment_list, viewer, viewer_diff_mode, terminal, editor, overlay). # # [keybinds.keys] # "ctrl+q" = "quit" # # [keybinds.layers.worktree] # "j" = "navigate_down" # "down" = "navigate_down" # "w" = "create_worktree" [ccusage] # enabled = false # token usage display in the title bar (requires ccusage) # poll_interval_secs = 120 # polling interval in seconds [updates] # check_on_startup = true # check for new versions on startup # check_interval_secs = 3600 # minimum interval between checks (default: 1h) [api] # LLM provider for smart-worktree generation (turn a task description into a # branch name + initial Claude Code prompt). Each provider stands alone — a # failure surfaces to the user rather than falling back to another. # provider = "gemini" # "gemini" (Gemini API) | "claude" (claude -p CLI) | "command" (external) # model = "gemini-2.5-flash" # model used by the "gemini" provider # command = ["ollama", "run", "llama3"] # external command for provider = "command" # (prompt on stdin, completion on stdout) # command_timeout_secs = 60 # wall-clock timeout for the command provider (0 = no timeout) ``` ## Data Paths | Path | Description | |---|---| | `~/.config/conductor/config.toml` | User configuration | | `/.conductor/conductor.db` | Per-repo review database (gitignored) | | `/-worktrees/` | Default worktree directory | ## License MIT ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [S-Nakamur-a](https://github.com/S-Nakamur-a) - **Source:** [S-Nakamur-a/conductor](https://github.com/S-Nakamur-a/conductor) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-s-nakamur-a-conductor - Seller: https://agentstack.voostack.com/s/s-nakamur-a - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.