--json. Read the output contract first — it
explains the envelope, the automatic JSON switch when stdout is not a terminal, and the
exit codes. The pages below do not repeat it.
Create
pinbox init
Set up pinbox in a project:
.pinbox/, the git hook, and the agent skill.pinbox pin
Create a pin from the terminal, with no browser involved.
Read
pinbox summary
Counts and the event cursor, in one call.
pinbox list
Every pin, newest first.
pinbox show
One pin with its full thread.
Act on
pinbox reply
Add a message to a pin’s thread.
pinbox resolve
Mark a pin resolved, with a note.
pinbox link
Mirror a pin into an external tracker.
Inspect
pinbox export
Write pins to stdout as markdown or JSON.
pinbox doctor
Probe this machine’s capabilities.
The hub that stores your pins starts itself on first use. Two commands are plumbing
rather than surface:
serve runs that hub in the foreground for debugging, and session
is how agent hooks register with the hub and pull pin context. Both have --help;
neither appears in pinbox --help.