BugParcel

llms.txt for coding agents.

Agents should start at the machine-readable index, then use the local MCP server. Humans can follow the same rules below.

Fetch the index

The canonical agent brief lives at the site root. Prefer this over scraping marketing pages.

$ curl -s https://<host>/llms.txt

Locally while developing the landing site: /llms.txt.

What it tells agents

  • Install via Homebrew tap (brew tap AayushGokhale2005/bugparcel then brew install bugparcel) — not a from-source Rust build
  • CLI surface: capture, show, reproduce, verify, reduce
  • Isolation rules: detached worktrees only; never mutate the source branch
  • MCP tool list and the recommended diagnose → propose → verify loop
  • Pointers to /docs and /docs/install for longer human-readable detail

Install + MCP (agent-ready)

$ brew tap AayushGokhale2005/bugparcel
$ brew trust AayushGokhale2005/bugparcel
$ brew install bugparcel
$ bugparcel --version
bugparcel 0.1.1
$ export BUGPARCEL_HOME="./bugparcel-runs"
{
  "mcpServers": {
    "bugparcel": {
      "command": "bugparcel-mcp",
      "env": { "BUGPARCEL_HOME": "./bugparcel-runs" }
    }
  }
}

Recommended loop

  1. bugparcel_list_parcels / bugparcel_get_contract
  2. bugparcel_diagnose or bugparcel_reproduce
  3. Inspect the returned detached worktree — do not edit the source branch
  4. bugparcel_propose_fix (unified diff) or bugparcel_verify
  5. bugparcel_cleanup_worktrees
Source branches stay untouched. Patches land only in BugParcel worktrees. Cleanup removes only those worktrees.

Next