@crewpilot/agent 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,107 @@
1
+ # @crewpilot/agent
2
+
3
+ Your AI dev crew — plans, architects, builds, tests, and ships software autonomously. **55+ MCP tools** and **16 domain skills** for every phase of software development.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install @crewpilot/agent
9
+ ```
10
+
11
+ On install, Catalyst automatically creates `.github/` files in your project so the **@Catalyst agent** appears in Copilot Chat's agent dropdown.
12
+
13
+ ## Usage
14
+
15
+ ### As an MCP Server (VS Code, Cursor, Claude Desktop)
16
+
17
+ Add to `.vscode/mcp.json`:
18
+
19
+ ```json
20
+ {
21
+ "servers": {
22
+ "crewpilot": {
23
+ "command": "npx",
24
+ "args": ["@crewpilot/agent"]
25
+ }
26
+ }
27
+ }
28
+ ```
29
+
30
+ For Claude Desktop (`claude_desktop_config.json`):
31
+
32
+ ```json
33
+ {
34
+ "mcpServers": {
35
+ "crewpilot": {
36
+ "command": "npx",
37
+ "args": ["@crewpilot/agent"]
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
43
+ ### CLI Commands
44
+
45
+ ```bash
46
+ npx @crewpilot/agent # Start MCP server (stdio)
47
+ npx @crewpilot/agent init # Create .github/ files in current directory
48
+ npx @crewpilot/agent --help # Show usage
49
+ ```
50
+
51
+ ### Global Install
52
+
53
+ ```bash
54
+ npm install -g @crewpilot/agent
55
+ crewpilot # Start MCP server
56
+ crewpilot init # Setup .github/ files
57
+ ```
58
+
59
+ ## What Gets Created
60
+
61
+ On `npm install` (or `crewpilot init`), these files are created in your project:
62
+
63
+ | File | Purpose |
64
+ |---|---|
65
+ | `.github/agents/catalyst.md` | Agent definition — enables @Catalyst in Copilot Chat |
66
+ | `.github/copilot-instructions.md` | Project-level Copilot instructions |
67
+ | `.github/catalyst.config.json` | Platform configuration (thresholds, board settings) |
68
+ | `.github/skills/*/SKILL.md` | 16 domain skill files for on-demand skill loading |
69
+
70
+ Existing files are never overwritten.
71
+
72
+ ## MCP Tools (55)
73
+
74
+ | Module | Tools | Purpose |
75
+ |---|---|---|
76
+ | Terminal | 3 | Command execution and environment management |
77
+ | Git | 6 | Branch, commit, diff, log, stage, status |
78
+ | Knowledge | 9 | Persistent memory, search, semantic search, patterns |
79
+ | Metrics | 3 | Code complexity, bundle size, coverage analysis |
80
+ | Dispatch | 3 | Parallel execution, consensus, review workflows |
81
+ | Board | 13 | Task management, sprint tracking, PR integration |
82
+ | Orchestrator | 14 | Worker lifecycle, planning, branching, PR creation |
83
+ | Notification | 3 | Email and messaging notifications |
84
+ | Config | 1 | Runtime configuration management |
85
+
86
+ ## Skills (16)
87
+
88
+ Organized across five engineering pillars:
89
+
90
+ **Strategize** — Solution Design, Architecture Planner
91
+ **Assure** — Code Quality, Vulnerability Scan, PR Intelligence
92
+ **Engineer** — Feature Builder, Test-First, Root Cause Analysis
93
+ **Deliver** — Change Management, Deploy Guard, Doc Governance
94
+ **Insights** — Pattern Detection, Knowledge Base
95
+ **Automation** — Autopilot Worker, Autopilot Meeting, Daily Digest
96
+
97
+ ## VS Code Extension
98
+
99
+ For a richer experience with auto-start, agent switching, and automatic `.github/` syncing, install the [Catalyst VS Code Extension](https://marketplace.visualstudio.com/items?itemName=CrewPilot.crewpilot).
100
+
101
+ ## Requirements
102
+
103
+ - Node.js 20+
104
+
105
+ ## License
106
+
107
+ Proprietary — All rights reserved.
@@ -0,0 +1,25 @@
1
+ #!/usr/bin/env node
2
+ #!/usr/bin/env node
3
+ import o from"fs";import t from"path";import{fileURLToPath as y}from"url";var h=t.dirname(y(import.meta.url)),m=process.argv[2];if(m==="init"){let s=function(i,r){let e=t.join(l,i),n=t.join(c,r);if(o.existsSync(e)){if(o.existsSync(n)){console.log(` \u2713 ${r} (already exists)`),p++;return}o.mkdirSync(t.dirname(n),{recursive:!0}),o.copyFileSync(e,n),console.log(` \u271A ${r}`),a++}},f=function(){let i=t.join(l,"skills");if(!o.existsSync(i))return;let r=o.readdirSync(i).filter(e=>o.statSync(t.join(i,e)).isDirectory());for(let e of r){let n=t.join(i,e,"SKILL.md");if(!o.existsSync(n))continue;let g=t.join("skills",e,"SKILL.md"),d=t.join(c,g);if(o.existsSync(d)){p++;continue}o.mkdirSync(t.dirname(d),{recursive:!0}),o.copyFileSync(n,d),console.log(` \u271A ${g}`),a++}};S=s,j=f;let u=process.cwd(),c=t.join(u,".github"),l=t.join(h,"..","prompts");o.existsSync(l)||(console.error("Error: prompts/ not found in package. Reinstall @crewpilot/agent."),process.exit(1));let a=0,p=0;console.log(`
4
+ \u26A1 CrewPilot \u2014 Initializing .github/ files
5
+ `),o.mkdirSync(c,{recursive:!0}),s("agent.md",t.join("agents","catalyst.md")),s("copilot-instructions.md","copilot-instructions.md"),s("catalyst.config.json","catalyst.config.json"),f(),console.log(`
6
+ Created: ${a} | Already existed: ${p}`),console.log(`
7
+ \u2705 Open Copilot Chat and select @Catalyst from the agent dropdown
8
+ `)}else m==="--help"||m==="-h"?console.log(`
9
+ CrewPilot \u2014 Your AI dev crew for the full software lifecycle
10
+
11
+ Usage:
12
+ crewpilot Start the MCP server (stdio transport)
13
+ crewpilot init Create .github/ files in current directory
14
+ crewpilot --help Show this help message
15
+
16
+ MCP Config (.vscode/mcp.json):
17
+ {
18
+ "servers": {
19
+ "crewpilot": {
20
+ "command": "npx",
21
+ "args": ["@crewpilot/agent"]
22
+ }
23
+ }
24
+ }
25
+ `):await import("./index.js");var S,j;