Skip to content

Scripts and agents

Terminal window
hb --json --limit 10 "agent:codex api error" # one JSON object on stdout
hb --json --include-messages --limit 1 "auth" # with the conversation text
hb pin claude:5f0c2a9e-... # also: unpin, rename, hide, unhide
hb fork --json --to codex claude:5f0c2a9e-... # the new session as JSON, nothing launched
hb --agent-context # instructions for a coding agent

--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.

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.

Terminal window
hb . # resume the newest session of this folder
hb . --print # print the folder and the resume command instead of running it
hb --list # list sessions and exit