Skip to content

Latest commit

 

History

82 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Switchboard

CI OpenSSF Scorecard Latest release License: Apache-2.0

Mention it in Slack and an agent reviews the PR, ships the fix, or answers the question — on the model you choose, with its tools running where you decide.

A review in a Slack thread: the mention, the status card ticking through the run's steps, then the verdict with its findings.

A finished run's page on the dashboard.

Quick start

Node 24 and an Anthropic API key; no Slack.

npx @coreplane/switchboard init --organization <your GitHub org> --anthropic-key <your key>
npx @coreplane/switchboard ask "what can you do?"

init writes .env (mode 600) and config/config.yaml into ~/.switchboard, so every command works from any directory; ask runs the whole pipeline. curl -fsSL https://openswitchboard.dev/install.sh | sh is the same init.

Next: Get started.

How it is put together

Four seams: Channel, Provider, Executor, Agent. Each is an interface with more than one implementation. The dispatcher sits between them: directives, config layers, authorization, the agent loop (How a request flows).

flowchart LR
    subgraph channel ["Channel — how a request arrives"]
        C1["Slack"]
        C2["CLI"]
        C3["HTTP · MCP"]
    end
    D{"Dispatcher<br/>directives · config layers · authorization"}
    subgraph agent ["Agent — what runs"]
        AG["general · coding · review · ship · research · explore · conductor"]
    end
    subgraph provider ["Provider — the model"]
        P["Anthropic · OpenAI-compatible"]
    end
    subgraph executor ["Executor — where tools run"]
        E["local · sandbox · resident"]
    end
    C1 & C2 & C3 -->|"message"| D
    D -->|"runs"| AG
    AG <-->|"complete"| P
    AG <-->|"bash · read · write"| E
Loading

What you need

You need What it unlocks
Required A model provider key: Anthropic, or any OpenAI-compatible endpoint Every agent
For Slack A Slack app (Socket Mode: bot token + app-level token) The bot in your workspace
Optional A GitHub App, or a repo-scoped token Repository reads; pull requests
Optional A Cloudflare account Production: the bot plus the state, resident and sandbox Workers
Optional An E2B account Per-thread micro-VMs without Cloudflare
Optional A Brave Search key (BRAVE_SEARCH_API_KEY) Web search for the research agent

Off means absent from help, the dashboard and the plan (Turn features on and off). The bot is npx @coreplane/switchboard start on any machine with Node, or the published image ghcr.io/coreplanelabs/switchboard.

Learn more

Docs: https://openswitchboard.dev (docs/) · CONTRIBUTING.md · AGENTS.md · SECURITY.md · Apache-2.0.

About

Mention it in Slack and an agent reviews the PR, ships the fix, or answers the question — on the model you choose, with its tools running where you decide.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages