v0.14.0

capcom — v0.14.0 — 2026-11-01

This release lets the capcom block live in a file of your choosing instead of AGENTS.md, and makes capcom ready and capcom next explain an empty result.

Breaking changes

• New stores use store format 6 — capcom init now writes format: 6 into .capcom/config.yaml, and earlier capcom releases refuse to open a store that declares it. What to do: upgrade capcom on every machine and agent that works in the repository before creating a store with this release, or before raising an existing store to format: 6 to use agents.file.

New

• Put the capcom block in a file other than AGENTS.md — set agents.file in .capcom/config.yaml to a path inside the repository (such as docs/capcom.md) and capcom keeps its block there; it defaults to AGENTS.md, cannot also be listed under agents.guides, and needs format: 6, with a clear error telling you to set it when the store declares an older format.
• capcom agents and capcom check follow the chosen block file — capcom agents writes the block there, creating the file and any missing folders, and adds an import line such as @docs/capcom.md to an AGENTS.md that lacks one. When the block lives outside AGENTS.md, capcom check and capcom agents --check fail if AGENTS.md is missing, does not import the block file, or still holds capcom block markers, and capcom agents warns about a missing AGENTS.md without creating it.
• capcom ready and capcom next explain an empty list caused by ready.hide — when every Ready issue is hidden by a ready.hide label, both commands now warn how many are hidden and by which labels, and point to --show-hidden; the warning appears as a warning: line, in the --json warnings array and as a WARNING= line under next --kv, and capcom next still exits with code 4.

Improved

• Output names the file it actually wrote — capcom agents (including the path field of its --json output), the refreshed: line from know add, know update, know mv and know rm, the hint from capcom init, and capcom's errors about the block now name the block file in use rather than always saying AGENTS.md.

Docs & install

• Documentation for agents.file — the agent setup, Managed block and quickstart guides, the file-format reference, the glossary and the help for capcom agents, capcom know and capcom know add now explain how to keep the capcom block outside AGENTS.md and what capcom check reports about it.