
AI engineering copilot with 55+ MCP tools and 16 domain skills for every phase of software development — from brainstorming architecture to shipping production releases.
Features
Catalyst is organized around five engineering pillars plus automation:
Strategize
- Solution Design — Brainstorm ideas, explore options, evaluate tradeoffs
- Architecture Planner — Plan architecture, design system structure, write RFCs
Assure
- Code Quality — Review code quality, clean code analysis, refactoring guidance
- Vulnerability Scan — Security audit with OWASP/CWE vulnerability scanning
- PR Intelligence — PR summarization, change inventory, risk assessment
Engineer
- Feature Builder — Build features, implement & scaffold new code
- Test-First — TDD workflow, unit tests, coverage analysis
- Root Cause Analysis — Debug errors, investigate crashes, find root causes
Deliver
- Change Management — Conventional commits, changelogs, version & release management
- Deploy Guard — Pre-deploy safety checks, ship readiness validation
- Doc Governance — Documentation freshness, README maintenance, stale docs detection
Insights
- Pattern Detection — Codebase health trends, anti-pattern detection
- Knowledge Base — Persistent memory recall, decision history, context retrieval
Automation
- Autopilot Worker — Autonomous task pickup & implementation pipeline
- Autopilot Meeting — Parse meeting transcripts, extract action items
- Daily Digest — EOD/weekly summary reports and email notifications
| Module |
Tools |
Purpose |
| Terminal |
3 |
Command execution and environment management |
| Git |
6 |
Branch, commit, diff, log, stage, status |
| Knowledge |
9 |
Persistent memory, search, semantic search, patterns |
| Metrics |
3 |
Code complexity, bundle size, coverage analysis |
| Dispatch |
3 |
Parallel execution, consensus, review workflows |
| Board |
13 |
Task management, sprint tracking, PR integration |
| Orchestrator |
14 |
Worker lifecycle, planning, branching, PR creation |
| Notification |
3 |
Email and messaging notifications |
| Config |
1 |
Runtime configuration management |
Getting Started
Prerequisites
| Requirement |
Version |
| VS Code |
1.101+ |
| GitHub Copilot Chat |
Latest |
Install from VS Code Marketplace
- Open VS Code
- Go to Extensions sidebar (
Cmd+Shift+X)
- Search for "Catalyst — Engineering Intelligence Platform"
- Click Install
Or install directly from the marketplace:
Catalyst on VS Code Marketplace
Install from VSIX (manual)
If you have the .vsix file (e.g., from a private build):
Option 1 — VS Code UI:
- Open VS Code → Extensions sidebar (
Cmd+Shift+X)
- Click the
... menu (top-right) → Install from VSIX...
- Select the
crewpilot-x.x.x.vsix file
Option 2 — Command line:
code --install-extension crewpilot-x.x.x.vsix
Build from Source
To build the VSIX yourself from the source repository:
git clone https://github.com/amanraj-ms/catalyst.git
cd catalyst
bash scripts/vsix-package-creator.sh
This compiles the MCP server into a native binary, bundles the extension, and produces a .vsix file in the project root.
Install via npm (MCP server only)
You can also install the CrewPilot MCP server as a standalone npm package — no VS Code extension required:
# Run directly without installing
npx @crewpilot/agent
# Install globally
npm install -g @crewpilot/agent
crewpilot
# Install in a project
npm install @crewpilot/agent
Then add it to your VS Code MCP config (.vscode/mcp.json):
{
"servers": {
"crewpilot": {
"command": "npx",
"args": ["@crewpilot/agent"]
}
}
}
Or any other MCP-compatible client (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"crewpilot": {
"command": "npx",
"args": ["@crewpilot/agent"]
}
}
}
Note: The npm package includes the MCP server, skills, agent prompt, and config. The VS Code extension additionally provides auto-start, agent switching, and automatic .github/ syncing.
View on npm: @crewpilot/agent on npmjs.com
Quick Start
- Open any workspace — the extension activates automatically on startup.
- Switch to the Catalyst agent — open Copilot Chat and select
@Catalyst from the agent picker.
- Choose a role — Catalyst will ask for your session role: Strategize, Assure, Build, Deliver, or Insights.
- Start working — describe your task and Catalyst will route to the appropriate skill.
What Gets Synced
On activation, the extension syncs the following into your workspace's .github/ directory:
| File |
Purpose |
.github/agents/catalyst.md |
Agent definition for Copilot Chat agent switching |
.github/copilot-instructions.md |
Project-level Copilot instructions |
.github/catalyst.config.json |
Platform configuration (thresholds, board settings) |
.github/skills/*/SKILL.md |
16 domain skill files for on-demand skill loading |
Extension Settings
| Setting |
Default |
Description |
crewpilot.createAgentFile |
true |
Sync .github/agents/catalyst.md to workspace |
crewpilot.createSkillFiles |
true |
Sync .github/skills/ to workspace |
Commands
- Catalyst: Refresh MCP Server — Restart the MCP server connection
- Catalyst: Show Binary Path — Display the path to the MCP server binary
Troubleshooting
MCP Server Not Starting
- Run Catalyst: Show Binary Path to verify the binary exists.
- Check that
chat.mcp.discovery.enabled is true in your VS Code settings.
- Try Catalyst: Refresh MCP Server to restart the connection.
- Open the Command Palette → MCP: List Servers and check that CrewPilot is listed and running.
- If the server shows as stopped, click Start to launch it manually.
License
Proprietary — All rights reserved.