Sideboard Home Install Guides GitHub
Docs

Everything you need to run the fleet

Start with the CLI — it's the fastest way to see whether Sideboard fits how you already work. The desktop, MCP and Slack layer on top of the same local orchestrator.

Install

CLI

Ships the stdio MCP server too. Aliases: side → sideboard.

npm i -g @sideboard-ai/cli
sideboard detect

Desktop

Mac builds for Apple Silicon and Intel, from GitHub Releases. Auto-updates on launch and every four hours — never mid-session.

Latest release

Agent CLIs

Sideboard shells out to each agent's own CLI. Install the ones you want on your PATH and authenticate; Cursor uses the official SDK key instead.

npm i -g @anthropic-ai/claude-code
npm i -g @openai/codex
npm i -g opencode-ai@latest
export CURSOR_API_KEY="cursor_..."

Quick start

Board, send, inspect, attach when you want the native CLI, land when it's ready.

sideboard new --from branch:main --agent claude
sideboard ls
sideboard send <thread> "add a README note"
sideboard diff <thread>
sideboard attach <thread>        # native CLI, same session
sideboard land <thread>          # interactive y/N; no --yes in v1
sideboard adopt --from-conductor # import Conductor workspaces + history

Connect the MCP

The desktop auto-injects the MCP into its own turns. Register it yourself when you want fleet tools from an agent running outside Sideboard.

Claude Code

claude mcp add --scope user \
  sideboard -- sideboard mcp

Cursor

{ "mcpServers": { "sideboard": {
  "command": "sideboard",
  "args": ["mcp"] } } }

Codex

[mcp_servers.sideboard]
command = "sideboard"
args = ["mcp"]

OpenCode

{ "mcp": { "sideboard": {
  "type": "local",
  "command": ["sideboard","mcp"] } } }

Agents then get discovery (list_workspaces, list_threads), worktree chats (create_thread, send_to_thread, wait_for_turn, fork_worktree), structure panes, setup/run scripts, diffs, review and ask_git. Ready-for-review land and purge stay human-only.

Guides

Slack

Connect a workspace, name this Mac, and address it by prefix from a DM or channel.

Agent adapters

How each agent is spawned, what it supports, and how to add another one.

Remote integrations

The Slack relay, Linear OAuth, and what does and doesn't leave the machine.

Compare

Peer-by-peer notes against Conductor, Cursor, Emdash and Superset.

Security

Where credentials live, what the relay sees, and the v1 safety rails on landing.

Contributing

Monorepo layout, local dev commands, and how releases are cut.

Repo config

Worktrees live outside the repo at ~/sideboard/workspaces/<repo-slug>/<team>/. Override per repo in .sideboard/settings.toml — an existing .conductor/settings.toml is used as a fallback.

[scripts]
setup = "pnpm install"

[scripts.run.dev]
command = "PORT=${SIDEBOARD_PORT:-3000} pnpm --filter web dev"
default = true