Synopsis
Description
capy agents adds a marked Secrets (Capy) section to both AGENTS.md and CLAUDE.md in the repository, and creates whichever of the two is missing. Different agents read different files, so both always carry the section. The section tells an agent to use capy help --json, use error codes rather than message text, and avoid printing or passing secret values as command arguments.
It also tells an agent how to handle an elicitation: show the person the display table, ask the question, and run the answer command. The section covers capy project: an agent creates or deletes a project only when the person asks, and it never adds --yes on its own.
The command finds the Git repository root. Outside a Git repository, it uses the current directory. It updates an existing Capy section in place and preserves content outside the markers.
Use --print to inspect the block without writing. Use --remove to remove only the marked Capy section from whichever of the two files exist. If removal leaves a file exactly empty, Capy removes that file.
Writing or removing asks for confirmation in a terminal. In automation, pass --yes; --non-tty prevents prompts and therefore requires --yes for either operation. --dry-run calculates the changes without writing and never prompts.
Flags
--dry-run is a global option, so use either capy --dry-run agents or capy agents --dry-run.
See also
Last modified on November 10, 2026