beads/docs/cli-reference
Chris Sells 5f6bd2c87a docs: fix integration-page fact errors; restore three lost source edits
A second adversarial fact-check pass (372 claims across the 21 integration
and remaining getting-started pages: 291 verified, 22 contradicted) drove
these corrections, each reproduced against the binary or repo source:

- junie.md: the recipe-written MCP config invokes `bd mcp`, which does not
  exist in current builds — the page now warns about that and points at
  the working standalone beads-mcp server config. (The recipe itself,
  cmd/bd/setup/junie.go, still writes the dead config — recorded as a
  product follow-up, out of docs scope.)
- claude-code-plugin.md: the plugin (v1.1.0 manifest) ships skills,
  commands, and hooks — no MCP server. Removed the bundled-server claims,
  uv prerequisite, phantom `init` tool, stale 0.9.2 version pin, and the
  unverified env-var list; MCP guidance now points at the standalone
  server. installation.md's plugin-MCP troubleshooting entry updated to
  the same reality.
- upgrading.md: `bd migrate --cleanup` doesn't exist; the doctor
  migration-skew note was inverted (the check DOES run in embedded mode —
  cmd/bd/doctor/migration_skew.go); `dolt sql-server --stop` is not a
  flag.
- sync-setup.md: `bd vc log` doesn't exist (vc has commit/merge/status);
  use `bd history`.
- azure-devops.md: sync flag table listed phantom --label/--status/--type
  (real: --states/--types/--issues); error strings now quote the actual
  binary messages (MDX-safe).
- github-copilot.md: beads-mcp has no --version flag; verify with
  pip show beads-mcp. aider.md's config sample now matches the generated
  file byte-for-byte.

Also restores three source edits that a mid-script failure silently
dropped from the earlier printed-paths commit (whose message claimed
them): bd mol pour's help no longer says molecules are "synced with git",
the claude recipe's stale ProjectPath metadata
(.claude/settings.local.json -> .claude/settings.json), and the shared
recipe template's quickstart URL. CLI docs regenerated accordingly.

Gates: docsync, docsmint, recipes tests, generate-cli-docs.sh --check,
mint broken-links (no broken links), vet — all pass.
2026-07-12 10:37:18 -07:00
..
admin.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
ado.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
assign.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
audit.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
backup.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
batch.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
blocked.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
bootstrap.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
branch.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
children.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
close.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
comment.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
comments.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
compact.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
completion.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
config.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
context.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
cook.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
count.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
create-form.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
create.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
defer.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
delete.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
dep.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
diff.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
doctor.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
dolt.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
duplicate.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
duplicates.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
edit.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
epic.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
export.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
federation.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
find-duplicates.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
flatten.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
forget.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
formula.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
gate.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
gc.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
github.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
gitlab.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
graph.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
heartbeat.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
history.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
hooks.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
human.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
import.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
index.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
info.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
init-safety.md fix(cli): printed doc paths point at the new docs locations 2026-07-12 10:37:17 -07:00
init.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
jira.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
kv.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
label.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
linear.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
link.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
lint.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
list.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
mail.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
memories.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
merge-slot.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
metrics.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
migrate-personal.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
migrate.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
mol.md docs: fix integration-page fact errors; restore three lost source edits 2026-07-12 10:37:18 -07:00
note.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
notion.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
onboard.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
orphans.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ping.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
preflight.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
prime.md fix(cli): printed doc paths point at the new docs locations 2026-07-12 10:37:17 -07:00
priority.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
promote.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
prune.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
purge.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
q.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
query.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
quickstart.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ready.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
recall.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
reclaim.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
recompute-blocked.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
remember.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
rename-prefix.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
rename.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
reopen.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
repo.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
restore.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
rules.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
search.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
set-state.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
setup.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
ship.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
show.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
sql.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
stale.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
state.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
status.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
statuses.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
supersede.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
swarm.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
tag.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
todo.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
types.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
unclaim.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
undefer.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
update.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
upgrade.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
vc.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00
version.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
where.md docs(emitter): emit Mintlify CLI reference and generated docs.json nav 2026-07-12 10:37:07 -07:00
worktree.md docs(emitter): Cobra-accurate usage lines, published global flags, MDX ESM guard 2026-07-12 10:37:17 -07:00