Scripts and agents
hb --json --limit 10 "agent:codex api error" # one JSON object on stdouthb --json --include-messages --limit 1 "auth" # with the conversation texthb pin claude:5f0c2a9e-... # also: unpin, rename, hide, unhidehb fork --json --to codex claude:5f0c2a9e-... # the new session as JSON, nothing launchedhb --agent-context # instructions for a coding agentJSON output
Section titled “JSON output”--json has a versioned schema with paging, and every session carries the
exact resume_command. stdout carries exactly one JSON object, and notices go
to stderr. The JSON output reference has the schema.
For coding agents
Section titled “For coding agents”hb --agent-context prints an Agent Skill that tells a coding agent how to
search, page and resume safely.
llms.txt has the short
version.
Without the list
Section titled “Without the list”hb . # resume the newest session of this folderhb . --print # print the folder and the resume command instead of running ithb --list # list sessions and exit