Bridge GitHub Copilot CLI to messaging platforms. Send messages from Mattermost (or other platforms) and get responses from Copilot sessions running on your machine.
Mattermost Channel → copilot-bridge → @github/copilot-sdk → Copilot CLI
↑ ↓
└──────────── streaming response (edit-in-place) ←─────────┘
More screenshots here.
- Multi-bot support — Run multiple bot identities on the same platform (e.g.,
@copilotfor admin,@alicefor tasks) - Workspaces — Each bot gets an isolated workspace with its own
AGENTS.md,.envsecrets,MEMORY.md, and optionalAGENTS.local.mdfor per-operator conventions - DM auto-discovery — Just message a bot; no channel config needed for direct messages
- Streaming responses — Edit-in-place message updates with throttling
- MCP & skills — Auto-loads MCP servers and skill directories from Copilot config
- Fuzzy model matching —
/model opusresolves toclaude-opus-4.6(mobile-friendly) - Copilot Fusion —
/fusion highselects a policy-permitted routing tier; live notices show the models doing the work and review - Bring Your Own Key (BYOK) — Connect your own providers (Ollama, Azure, Anthropic) alongside Copilot models
- Assisted permissions — Choose manual approval, AI safety review, or yolo independently of the autonomous
/autopilotloop - Model fallback — Automatic fallback to alternative models on capacity/availability errors
- Loop detection — Detects and breaks tool call loops with user notification
- Session management —
/reloadto refresh config,/resumeto switch between sessions (prefix matching supported) - Persistent preferences — Model, agent, verbose mode, permissions saved per-channel
- Scheduled tasks — Recurring (cron) and one-off (datetime) tasks per channel
- Inter-agent communication — Bot-to-bot messaging via
ask_agenttool - File sharing —
send_fileandshow_file_in_chattools for pushing files to chat - Attachment ingestion — File and image attachments are extracted and passed to the session
- Mid-turn steering — Send messages while the bot is working to redirect it
- Streamer mode — Hide preview/internal models from
/modellist for on-air use - Thread-aware replies — Reply in threads via 🧵 trigger or per-channel config
- Config hot-reload —
/reload configapplies safe changes without restarting the bridge - Admin onboarding — Templates and tools for creating channels, managing workspaces
- Prerequisites: Node.js 22.12.0+, GitHub Copilot CLI installed and authenticated
- Install (pick one):
- npm:
npm install -g @chrisromp/copilot-bridge - From source:
git clone https://github.com/ChrisRomp/copilot-bridge.git && cd copilot-bridge && npm install
- npm:
- Configure:
copilot-bridge init(ornpm run initfrom source) — interactive wizard - Validate:
copilot-bridge check(ornpm run check) - Run:
copilot-bridge start(ornpm run devfor development with watch mode)
For DMs, that's it — the bridge auto-discovers DM channels for each bot. For group channels, add a channels entry mapping the channel ID to a working directory. See the Setup Guide for the full walkthrough or Configuration for reference.
See the Setup Guide — Running as a Service for macOS (launchd) and Linux (systemd) instructions, or run copilot-bridge install-service to install automatically.
| Command | Aliases | Description |
|---|---|---|
| Session | ||
/new |
Start a fresh session | |
/stop |
/cancel |
Stop the current task |
/reload |
Reload session (re-reads AGENTS.md, AGENTS.local.md, workspace config) | |
/reload config |
Hot-reload config.json (safe changes apply without restart) | |
/resume [id] |
List past sessions, or resume one by ID | |
/model [name] |
/models |
List models or switch model (fuzzy match) |
/fusion [standard|high|max|default] |
/model fusion, /model auto |
Select Fusion; no tier reuses the saved choice |
/agent <name> |
Switch custom agent (empty to deselect) | |
/reasoning <level> |
Set reasoning effort (low/medium/high/xhigh) |
|
/context-tier <tier> |
Set context tier (default/long; max also accepted) |
|
/context |
Show context window usage | |
/verbose |
Toggle tool call visibility | |
/status |
Show session info | |
| Permissions | ||
/approve / /deny |
Handle pending permission request | |
/always approve |
/remember |
Approve + persist the permission rule |
/always deny |
Deny + persist the permission rule | |
/rules |
/rule |
List saved permission rules |
/rules clear [spec] |
Clear rules (all, or by spec) | |
/permissions [manual|assisted|yolo] |
Show current and available modes, or switch mode | |
/assisted [on|off] |
Toggle AI-assisted permission review | |
/yolo |
Toggle auto-approve permissions | |
/autopilot |
/auto |
Toggle autonomous loop without changing permission mode |
| Planning | ||
/plan |
Toggle plan mode (structured planning before implementation) | |
/plan show |
Display the current plan | |
/plan clear |
Delete the plan | |
| Scheduling | ||
/schedule |
/schedules, /tasks |
Manage scheduled tasks (list, cancel, pause, resume, history) |
| Tools & Info | ||
/skills |
/tools |
Show available skills and MCP tools |
/skills enable <name...> |
Enable skills for this channel (all for bulk) |
|
/skills disable <name...> |
Disable skills for this channel (all for bulk) |
|
/mcp |
Show MCP servers and their source | |
/provider |
/providers |
List configured BYOK providers |
/provider test <name> |
Test provider connectivity | |
/streamer-mode |
/on-air |
Toggle streamer mode (hides preview/internal models) |
/help |
Show common commands; /help all for full list |
- Configuration — Platforms, channels, permissions, defaults
- Bring Your Own Key (BYOK) — Connect external model providers (Ollama, Azure, Anthropic)
- Workspaces & Agents — Workspace system, .env secrets, templates, agent onboarding
- Architecture — Source layout, message flow, adapter pattern, persistence
MIT

