--json, --non-tty - Capy cannot ask, so it stops, changes nothing, and exits with code 3.
With --json, that stop carries an elicitation next to its code: a question for the person, never for the agent. The agent asks the person, then runs the command that answers it.
--json and --non-tty
Agents and CI pass --json. It means: never ask, and answer with one JSON object on standard output. Messages for people go to standard error.
--non-tty means the same as --json on the commands that ask these questions (capy project create, delete, and restore). With neither flag and no terminal, those commands still never ask, but they print only a message on standard error, with no elicitation.
What the agent does
-
Write the
displaytable in your reply exactly as given. Do not shorten or reorder it, and do not put it inside the question. -
Ask the short
questionwith your question tool: one question per field, using the field’s ownquestionfollowed by itsdescriptionwhen it has them, and itsoptionsordefaultas the choices. If you have no question tool, end your reply with thequestionand let the person answer in chat. A field withoutoptionsis typed in. With adefault, offer exactly two choices, thedefaultand “Cancel”; the person types any other answer in the question tool’s own free-text answer. With nodefault, leave it out of the question tool: after the other questions, ask itsquestionin chat and let the person type the answer. On “Cancel”, stop. - Run the answer command with what the person chose.
--yes on your own.
capy agents writes the same instructions into AGENTS.md and CLAUDE.md, so an agent working in your repository has them.
The two kinds
confirm
A yes or no.
answer.yes. It keeps any flag the person already chose, such as --force. On no, stop.
form
One or more values.
answer.rerun with the values filled in.
details holds names, ids, counts, and dates only, never a secret value, a hash, or ciphertext.
Today’s elicitations
See
capy project for each command.
Error codes
Branch oncode, never on the message text.
See also
capy project- create, delete, and restore projectscapy agents- tell coding agents in your repository how to use Capycapy help- the machine-readable command reference, including every error code