Skip to content
Back to search

mcp-github-project-manager

MCP server for AI-powered GitHub project management — 20 tools, 169 actions, agent swarm orchestration, GitHub Actions/Releases/Branches, MCP Resources & Prompts, PRD-to-issues pipeline

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kunwarVivek/mcp-github-project-manager with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kunwarVivek/mcp-github-project-manager'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kunwarvivek--mcp-github-project-manager/badge.svg)](/listings/kunwarvivek--mcp-github-project-manager)

HTML

<a href="/listings/kunwarvivek--mcp-github-project-manager"><img src="/api/listings/kunwarvivek--mcp-github-project-manager/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Using NPM

# Install the package globally
npm install -g mcp-github-project-manager

# Set up your environment variables
export GITHUB_TOKEN="your_github_token"
export GITHUB_OWNER="your_github_username_or_organization"
export GITHUB_REPO="your_repository_name"

# Run the MCP server
mcp-github-project-manager

Using Docker

# Build the Docker image
docker build -t mcp-github-project-manager .

# Run with environment variables
docker run -it \
  -e GITHUB_TOKEN=your_github_token \
  -e GITHUB_OWNER=your_github_username_or_organization \
  -e GITHUB_REPO=your_repository_name \
  mcp-github-project-manager

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 276 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MCP GitHub Project Manager
  2. <!-- Keywords: mcp server, model context protocol, github project management, ai agent orchestration, multi-agent coordination, autonomous coding agents, prd generator, sprint planning ai, issue triage automation, github projects v2 api, claude mcp, codex mcp, cursor mcp, llm tools, agentic task management, ai project manager, swarm coordination, github actions, github releases, branch protection, mcp resources, mcp prompts -->
  3. [![npm version](https://img.shields.io/npm/v/mcp-github-project-manager.svg)](https://www.npmjs.com/package/mcp-github-project-manager)
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  5. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/kunwarvivek-mcp-github-project-manager-badge.png)](https://mseep.ai/app/kunwarvivek-mcp-github-project-manager)
  6. **The task substrate for AI coding agents.** An [MCP](https://modelcontextprotocol.io) server that turns GitHub Projects v2 into an agentic project-management layer: agents register, self-assign work, heartbeat, submit work products for review, and spend against token budgets — through **<!-- count:tools -->21<!-- /count --> compound tools exposing <!-- count:actions -->175<!-- /count --> actions**, backed entirely by GitHub-native storage. No database, no Redis, no external infra.
  7. You bring the agents (Claude Code, Codex, Cursor, Windsurf, Roo, OpenCode, any MCP client). This is the backbone that tells them what to work on and keeps them from colliding.
  8. | Surface | Detail |
  9. |---|---|
  10. | Tools | <!-- count:tools -->21<!-- /count --> compound tools, <!-- count:actions -->175<!-- /count --> actions, `action`-routed |
  11. | Resources | 6 read-only GitHub-backed views |
  12. | Prompts | 6 reusable AI templates |
  13. | Transport | MCP v2 over stdio (webhook/SSE optional) |
  14. | Storage | GitHub issues, project fields, comments — no external infra |
  15. | Runtime | Node >= 22.12.0 · MIT license |
  16. ## Why this exists
  17. - **Agents need a work queue, not a chat window.** `agent_work` / `agent_manage` give agents atomic task checkout, heartbeats, and a review loop instead of "go figure it out."
  18. - **Budgets must be enforced somewhere the agent cannot skip.** Each agent has a token budget with warning thresholds and a hard stop; the server debits itself, and `record_usage` covers the agent's own runtime spend.
  19. - **AI plans are worthless if they never become issues.** `ai_generate` runs idea → PRD → tasks → materialized GitHub issues, grouped into milestones and sprints.
  20. - **Tool lists are a context tax.** <!-- count:tools -->21<!-- /count --> tools instead of <!-- count:actions -->175<!-- /count --> keeps the schema small; `discover_tools` expands any domain or action on demand.
  21. - **State should live where the work already is.** The agent registry is a file on a dedicated branch (compare-and-swap writes), task claims are project fields, work products are issue comments — no new infrastructure to operate.
  22. ## Quick start
  23. Requires Node.js **>= 22.12.0** (Node 24 recommended).
  24. ```bash
  25. # 1. Install (global, or use npx / pnpm dlx / docker compose — see below)
  26. npm install -g mcp-github-project-manager
  27. # 2. Configure — pick ONE credential (GITHUB_TOKEN is not required)
  28. export GITHUB_TOKEN="ghp_..." # a PAT, or
  29. # mcp-github-project-manager auth login --gh # zero registration: sets up the GitHub CLI login, or
  30. # GITHUB_OAUTH_CLIENT_ID=<id> mcp-github-project-manager auth login # OAuth device flow, or
  31. # nothing at all if `gh auth login` is already done (needs the `project` scope: `gh auth refresh -h github.com -s project`)
  32. export GITHUB_OWNER="your-org-or-user"
  33. export GITHUB_REPO="your-repo"
  34. # 3. Run the MCP stdio server
  35. mcp-github-project-manager
  36. ```
  37. Register it with an MCP client:
  38. ```json
  39. {
  40. "mcpServers": {
  41. "github-project-manager": {
  42. "command": "npx",
  43. "args": ["-y", "mcp-github-project-manager"],
  44. "env": {
  45. "GITHUB_TOKEN": "ghp_...",
  46. "GITHUB_OWNER": "your-org-or-user",
  47. "GITHUB_REPO": "your-repo"
  48. }
  49. }
  50. }
  51. }
  52. ```
  53. ```bash
  54. # Claude Code CLI
  55. claude mcp add github-project-manager -- npx -y mcp-github-project-manager
  56. # Docker
  57. docker compose up --build
  58. # Docker + OAuth sign-in (token persists in the gpm-data volume at /data)
  59. docker run -it --rm -v gpm-data:/data -e GITHUB_OAUTH_CLIENT_ID=<id> mcp-github-project-manager auth login
  60. docker run -i --rm -v gpm-data:/data -e GITHUB_OAUTH_CLIENT_ID=<id> mcp-github-project-manager
  61. ```
  62. Bind-mounting a host directory at `/data` requires it to be owned by uid `10001` (the container user). For headless/CI use a GitHub App or PAT instead — see the [Deployment Guide](docs/deployment.md#docker).
  63. Install paths: `npm install -g mcp-github-project-manager`, `npx -y mcp-github-project-manager`, `pnpm dlx mcp-github-project-manager`, or `docker compose up --build`.
  64. A GitHub token (if you use a PAT) needs `repo`, `project`, and `write:org` scopes. Prefer not to create one? Run `mcp-github-project-manager auth login --gh` (no OAuth app needed; it drives the GitHub CLI login and checks the `project` scope), or sign in with your own account via the OAuth device flow (`GITHUB_OAUTH_CLIENT_ID=<id> mcp-github-project-manager auth login`; see [OAuth device flow](docs/CONFIGURATION.md#oauth-device-flow-auth-login)). Full setup options live in the [Deployment Guide](docs/deployment.md) and the [Getting Started tutorial](docs/tutorials/getting-started.md).
  65. Works with any stdio MCP client — Claude Desktop, Claude Code, Codex, Cursor, Windsurf, Roo Code, VS Code + Copilot, OpenCode, and custom harnesses.
  66. ## The tool surface
  67. Every tool takes an `action` string that routes to the underlying operation, so clients see <!-- count:tools -->21<!-- /count --> schemas instead of <!-- count:actions -->175<!-- /count -->.
  68. | Tool | Group | Actions | Covers |
  69. |---|---|---|---|
  70. | `manage_project` | core | 38 | Projects v2: CRUD, close/reopen, fields, views, items, templates, repo/team linking, collaborators |
  71. | `manage_issues` | core | 22 | Issue CRUD, comments, drafts, advanced search, sub-issues, native blockers, issue types |
  72. | `manage_prs` | core | 7 | Create, list, update, merge, reviews |
  73. | `manage_milestones` | core | 7 | CRUD, metrics, overdue and upcoming |
  74. | `manage_sprints` | core | 9 | Create, update, delete (needs `confirm: true`), plan, add/remove issues, metrics |
  75. | `manage_labels` | core | 2 | Create and list repository labels |
  76. | `manage_automation` | core | 3 | Project workflows: list, get, delete |
  77. | `manage_iterations` | core | 5 | Iteration config, current iteration, items, by-date, assign |
  78. | `manage_status_updates` | core | 3 | Project status updates: create, list, get |
  79. | `manage_branches` | core | 4 | Branch protection rules and branch listing |
  80. | `manage_releases` | core | 6 | Releases: create, list, get, update, delete, latest |
  81. | `manage_workflows` | core | 6 | GitHub Actions: list, dispatch, run status/logs, cancel |
  82. | `manage_events` | events | 3 | Subscribe, recent events, replay |
  83. | `ai_generate` | ai | 9 | PRD generate/enhance/parse, features, next task, complexity, expand, traceability, materialize |
  84. | `ai_analyze` | ai | 8 | Issue enrichment, triage, label suggestion, duplicate and related detection |
  85. | `ai_plan` | ai | 6 | Capacity, backlog priority, risk, sprint composition, roadmap, visualization |
  86. | `agent_work` | agents | 12 | Register, checkout, release, complete, heartbeat, review, task context |
  87. | `agent_manage` | agents | 18 | Registry, activity, work products, budgets, usage, PM coordination, convergence |
  88. | `system` | system | 2 | Health check (live GitHub rate-limit probe), project field setup |
  89. | `analytics` | core | 5 | Read-only sprint velocity and burndown, cycle time, throughput, project summary |
  90. | `discover_tools` | system | meta | Runtime discovery of tools, actions, and parameters |
  91. Call shape — one discriminator, action-specific parameters:
  92. ```json
  93. { "tool": "manage_project", "arguments": { "action": "create", "title": "Q3 Roadmap", "owner": "myorg" } }
  94. { "tool": "manage_issues", "arguments": { "action": "create", "title": "Add login form", "body": "..." } }
  95. { "tool": "agent_work", "arguments": { "action": "checkout_task", "agentId": "agent-abc123", "strategy": "highest_priority" } }
  96. { "tool": "discover_tools", "arguments": { "domain": "sprints" } }
  97. ```
  98. `discover_tools` takes an optional `domain` (projects, issues, pull_requests, milestones, sprints, labels, automation, iterations, events, status_updates, analytics, ai_generation, ai_analysis, ai_planning, agents, system) or a free-text `query`. It stays exposed even when tool groups are filtered.
  99. Cross-cutting contract: create actions accept an optional `idempotencyKey` (a retry within 24 h replays the first result instead of duplicating it); list actions that page return an additive `nextCursor` to pass back as `cursor`; every tool advertises `_meta.schemaVersion`. See [docs/TOOLS.md](docs/TOOLS.md#cross-cutting-parameters).
  100. Alongside the tools the server exposes **6 read-only resources** (`github://config`, `github://projects`, `github://sprints/current`, `github://milestones`, `github://agents`, `github://tools`) and **6 prompts** (`review-prd`, `explain-task-complexity`, `suggest-issue-labels`, `analyze-sprint-risk`, `generate-release-notes`, `triage-issue`).
  101. Full parameter reference: [docs/TOOLS.md](docs/TOOLS.md).
  102. ## What it can do
  103. **AI generation** (`ai_generate`) — generate a PRD from an idea, enhance an existing one, parse a PRD into tasks, add a feature with impact analysis, recommend the next task, analyze complexity and risk, expand a task into subtasks, build a traceability matrix, and materialize tasks into real GitHub issues.
  104. **AI analysis** (`ai_analyze`) — enrich one or many issues, triage (single or bulk), suggest labels, detect duplicates, find related issues.
  105. **AI planning** (`ai_plan`) — calculate sprint capacity, prioritize a backlog, assess risk, suggest sprint composition, generate a roadmap or visualization. Given a `projectId` the roadmap is planned from that project's own issues; with `autoCreate` the milestones are created and assigned to them.
  106. **Agent swarm** (`agent_work` / `agent_manage`) — agents register with role, runtime, and capabilities; claim tasks by priority, age, skills, or deadline; heartbeat with progress and blockers; submit work products (branch, PR, files, test results) for review; approve, reject, or decompose. PM-side actions add budgets, usage accounting, stale-agent reclaim, workload rebalancing, smart assignment, and one-call project convergence.
  107. **Deterministic GitHub surface** — projects, issues, pull requests, milestones, sprints, labels, branches, releases, workflows, project automations, events, status updates, and analytics, all with plain `action` routing and no model in the loop.
  108. The AI tools are optional. Without a provider key, everything else works unchanged.
  109. ### The agent loop, end to end
  110. ```json
  111. { "tool": "agent_work", "arguments": { "action": "register", "name": "claude-eng-1", "role": "engineer", "runtime": "claude-code", "capabilities": ["typescript", "testing"] } }
  112. { "tool": "agent_work", "arguments": { "action": "checkout_task", "agentId": "agent-abc123", "strategy": "highest_priority" } }
  113. { "tool": "agent_work", "arguments": { "action": "get_task_context", "issueNumber": 42 } }
  114. { "tool": "agent_work", "arguments": { "action": "heartbeat", "agentId": "agent-abc123", "status": "working", "taskId": "issue-42", "progress": 60, "currentBranch": "feat/42-add-login-form" } }
  115. { "tool": "agent_manage", "arguments": { "action": "submit_work_product", "agentId": "agent-abc123", "taskId": "issue-42", "issueNumber": 42, "branch": "feat/42-add-login-form", "prNumber": 99, "summary": "Added login form with validation" } }
  116. { "tool": "agent_work", "arguments": { "action": "complete_task", "agentId": "agent-abc123", "taskId": "issue-42", "summary": "Implemented and tested" } }
  117. ```
  118. A runnable version of this loop (worker + reviewer, every id threaded from the previous response, non-zero exit on any failure) lives in [`examples/basic/agent-loop.ts`](examples/basic/agent-loop.ts); `--plan` prints the call sequence with symbolic references.
  119. Checkout strategies: `highest_priority`, `oldest_first`, `skills_match`, `milestone_deadline`, `ai`. Budgets are set with `agent_manage` and `action: "set_budget"`; reset periods are `daily`, `weekly`, `monthly`, or `never`.
  120. Where the state lives — no external database:
  121. | Data | GitHub-native storage |
  122. |---|---|
  123. | Agent registry | `registry.json` on the `agent-registry` branch (Contents API, sha compare-and-swap) |
  124. | Task claims | Project custom fields (`agent_claimed_by`, `agent_status`, `agent_pr_number`, …) |
  125. | Work products | Structured issue comments |
  126. | Budgets and heartbeats | Agent records in the registry |
  127. ## Configuration
  128. | Variable | Required | Purpose |
  129. |---|---|---|
  130. | `GITHUB_TOKEN` | no\* | GitHub PAT (`repo`, `project`, `write:org`) — one of several credential options |
  131. | `GITHUB_OWNER` | yes | Owner (user or org) of the target repository |
  132. | `GITHUB_REPO` | yes | Target repository name |
  133. | `GITHUB_APP_ID`, `GITHUB_APP_PRIVATE_KEY`, `GITHUB_APP_INSTALLATION_ID` | no | GitHub App installation auth; highest-priority credential when all three are set (a partial set falls through to the next tier) |
  134. | `GITHUB_OAUTH_CLIENT_ID` (+ optional `GITHUB_OAUTH_CLIENT_SECRET`, `GITHUB_OAUTH_SCOPES`, `GITHUB_OAUTH_TOKEN_FILE`) | no | OAuth device flow for `auth login` |
  135. | `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GOOGLE_API_KEY`, `PERPLEXITY_API_KEY` | no | Unlocks the `ai_*` tools |
  136. | `AI_{MAIN,PRD,RESEARCH,FALLBACK}_{PROVIDER,MODEL,API_KEY,BASE_URL}` | no | Per-role provider, model, key, endpoint |
  137. | `MCP_TOOL_GROUPS` | no | Expose only some groups: `core`, `ai`, `agents`, `events`, `system` (default `all`) |
  138. | `SECRETS_DIR` | no | Read secrets from files named after the variable (Docker/k8s convention) |
  139. | `WEBHOOK_SECRET`, `WEBHOOK_PORT`, `SSE_ENABLED` | no | Webhook/SSE transport; signature validation fails closed |
  140. | `WEBHOOK_HOST`, `EVENTS_AUTH_TOKEN`, `WEBHOOK_TRUSTED_PROXIES` | no | HTTP hardening: binds `127.0.0.1` by default; `/events/*` needs the bearer token (or OAuth 2.1 settings below); `X-Forwarded-For` trusted only from listed proxies |
  141. | `SYNC_ENABLED`, `CACHE_DIRECTORY`, `MAX_CACHE_ENTRIES` | no | Bidirectional sync and cache tuning |
  142. | `RATE_LIMIT_FLOOR` | no | Remaining GraphQL points below which requests back off proactively (default 100) |
  143. | `AUDIT_LOG_ENABLED`, `AUDIT_LOG_PATH` | no | Append-only, redacted JSONL record of every state-changing tool call (`.mcp-audit/mutations.jsonl`) |
  144. | `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_SERVICE_NAME` | no | Opt-in OpenTelemetry tracing (`tool.<name>` spans) |
  145. | `AI_SESSION_TOKEN_LIMIT` | no | Per-operation token budget for AI task generation (distinct from per-agent budgets) |
  146. | `LOG_LEVEL`, `LOG_FORMAT` | no | `debug\|info\|warn\|error`, `text` or `json` |
  147. \* **Credential chain** (first hit wins, re-resolved per tool call): GitHub App installation → `--token` CLI flag → `$SECRETS_DIR/GITHUB_TOKEN` file → `GITHUB_TOKEN` env var → stored OAuth token from `auth login` → `gh auth token`. `GITHUB_TOKEN` is just one option; if you are already logged in with `gh`, you need no token configuration at all. The gh token is re-read every 60 s (and on a `401`); pin an account with `GH_CLI_USER`. Disable the fallback with `GH_CLI_TOKEN_FALLBACK=false`. CLI flags override env vars everywhere.
  148. The `/events/*` HTTP endpoints require a bearer token (`EVENTS_AUTH_TOKEN`) or OAuth 2.1 resource-server settings (`OAUTH_ISSUER` + `OAUTH_AUDIENCE`); with neither configured they answer `503` (set `EVENTS_ALLOW_UNAUTHENTICATED=true` for trusted dev only). See [Inbound HTTP authentication](docs/CONFIGURATION.md#inbound-http-authentication-events).
  149. Narrow the exposed surface with group filters (group names, not tool names):
  150. ```bash
  151. MCP_TOOL_GROUPS=core # project management only
  152. MCP_TOOL_GROUPS=core,ai # add the AI tools
  153. MCP_TOOL_GROUPS=all # default — everything
  154. ```
  155. **AI providers**: `anthropic`, `openai`, `google`, `google-vertex` (Gemini via Google ADC — `GOOGLE_VERTEX_PROJECT`), `perplexity`, and `openai-compatible` (OpenRouter, Together, Groq, Ollama, LM Studio, Azure OpenAI, …). There are **no default models** — you configure the models you use, per role, so you can run OpenRouter for cheap daily work and a frontier model for PRD generation.
  156. Full list: [docs/CONFIGURATION.md](docs/CONFIGURATION.md).
  157. ## Running it
  158. Every script is package-manager agnostic — `npm run X` and `pnpm run X` are identical, and both lockfiles are committed.
  159. | Task | Command |
  160. |---|---|
  161. | Build (tsc → `fix-imports.js` → chmod) | `npm run build` |
  162. | Typecheck (src + examples, src + tests) | `npm run typecheck` |
  163. | Lint | `npm run lint` |
  164. | Format | `npm run format` |
  165. | Unit tests | `npm test` |
  166. | Dev (watch) | `npm run dev` |
  167. | Coverage | `npm run test:coverage` |
  168. | E2E, mocked GitHub/AI | `npm run test:e2e:tools` |
  169. | E2E, live API (uses rate limit) | `E2E_REAL_API=true npm run test:e2e:tools:real` |
  170. | AI suites | `npm run test:ai` |
  171. | Inspect the server | `npm run inspect` |
  172. Point an MCP client at a local build with `{"command": "node", "args": ["build/index.js"]}`.
  173. Deployment and MCP-client setup: [docs/deployment.md](docs/deployment.md). When something misbehaves: [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md).
  174. ## Architecture at a glance
  175. Four layers, dependencies pointing inward:
  176. 1. **Domain** (`src/domain/`) — types, Zod schemas, errors, and rich entities (`entities/`) that carry their own invariants and state-transition logic. Orchestration and I/O live in services.
  177. 2. **Services** (`src/services/`) — business logic; `ProjectManagementService` orchestrates per-feature services, `src/services/ai/` holds the AI SDK providers.
  178. 3. **Infrastructure** (`src/infrastructure/`) — `github/` (Octokit GraphQL/REST), `tools/` (tool definitions, registry, validators, `compound/`), plus cache, persistence, resilience, events, secrets, logger, MCP resources and prompts.
  179. 4. **MCP** (`src/index.ts`) — boots `McpServer` (MCP v2) over stdio; every tool is registered with `registerTool` and shares one `dispatchTool` carrying the shutdown gate, in-flight tracking, and result formatting.
  180. `src/container.ts` wires the components `index.ts` owns with tsyringe DI; `src/env.ts` and `src/cli.ts` resolve configuration (CLI flags beat env vars). Tool executors self-construct through one shared factory (`createGitHubFactory()`), a documented exception to container resolution. Authentication is resolved once by `resolveGitHubAuth()` (GitHub App outranks the PAT) and all GitHub traffic goes through one `GitHubRequestExecutor` with retry and proactive rate-limit budgeting. AI providers plug in behind `AIServiceFactory`: it returns a model per role, wraps it in usage-reporting middleware, and the shared dispatcher debits the calling agent's budget once per tool call (a hard-stop budget gates AI tools with `BudgetExhausted`).
  181. A tool that runs and fails returns `{ content, isError: true }` with a stable code in `_meta.error` so the model can recover; a JSON-RPC error is reserved for an unknown tool or protocol faults.
  182. Design details: [docs/architecture.md](docs/architecture.md).
  183. ## Contributing
  184. Task tracking uses **[bd](https://github.com/gastownhall/beads)** (beads) — `bd ready`, `bd show <id>`, `bd update <id> --claim`, `bd close <id>`. Code traversal and audits use **GitNexus**: run impact analysis before editing a symbol and change analysis before committing. Refresh the index with `node .gitnexus/run.cjs analyze --index-only` when that runner exists in your checkout; otherwise bootstrap the CLI with `npx`/`bunx`/`pnpm dlx gitnexus@latest analyze`. Per-task recipes live in `.agents/skills/gitnexus-*/SKILL.md`.
  185. The quality gate, in order: `npm run build` → `npm run typecheck` → `npm run lint` → `npm test`.
  186. Traps that bite contributors:
  187. - **Source imports omit `.js`.** The `postbuild` step adds the extension. Never ship raw `tsc` output — always run the full build.
  188. - **`isolatedModules` is on.** A type re-exported as a value is a compile error; use `export type` / `import type`, including for decorated constructor parameters.
  189. - **Vitest rejects foreign test-runner CLI flags.** `--testPathPattern` fails with `CACError: Unknown option`; filter with a positional pattern and exclude with `--exclude='**/e2e/**'`.
  190. - **Mocks must use `function`, not an arrow,** wherever the code under test calls `new`. A `beforeEach` with an implicit return is treated as a teardown callback — use a block body.
  191. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/contributing/index.md](docs/contributing/index.md).
  192. ## License
  193. [MIT](LICENSE) — see [CHANGELOG.md](CHANGELOG.md) for the release history.
  194. ## Documentation
  195. | Guide | What it covers |
  196. |---|---|
  197. | [Tool Reference](docs/TOOLS.md) | <!-- count:tools -->21<!-- /count --> compound tools, <!-- count:actions -->175<!-- /count --> actions, per-action parameters |
  198. | [Configuration](docs/CONFIGURATION.md) | Every environment variable and per-role AI setup |
  199. | [Deployment](docs/deployment.md) | Install paths, Docker, MCP client configuration |
  200. | [Architecture](docs/architecture.md) | Layers, patterns, data flow, agent orchestration |
  201. | [User Guide](docs/user-guide.md) | Day-to-day usage |
  202. | [Tutorials](docs/tutorials/getting-started.md) | Step-by-step walkthroughs |
  203. | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common failures and fixes |
  204. | [Contributing](docs/contributing/index.md) | Development workflow and standards |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.