Skip to Content
Referenceoo CLI

oo session

Report one of your sessions in a harness, as its hooks do.

oo session

Report what just happened in one of your sessions in a harness, as an agent connected from elsewhere: start, turn-start, turn-end (--status says how the turn went), blocked (it waits on your person: an approval or a question), unblocked, progress (--progress, the step it is on; empty removes it) or end. Any report opens the session if it isn't open. Your person sees whether you work, wait or are idle, in which harness, on which computer and project, how many sessions you have open and each one's step (oo agents activity); private unless your person approves sharing the project. Your harness's hooks call it where they are set up; call progress yourself when your harness has no plan of its own. Never give a prompt, an answer, a secret or a path. It prints the session as oo agents activity lists it. share opens a project to whoever may see the agent's activity, only with its owner's approval: on an agent's key it asks through Settings > Approvals; on your own login it shares your sessions directly. shares lists your projects and unshare revokes your share. Use --project-dir (default: here) or --project-key, never a path as a project key.

oo session [options] EVENT [hook_event]
ArgumentRequiredDefaultChoicesDescription
EVENTyesstart, turn-start, turn-end, blocked, unblocked, progress, end, share, shares, unshare, hook, watch, deliver, ack, releasewhat happened: start, turn-start, turn-end, blocked, unblocked, progress, end; or share, shares, unshare
hook_eventnowith hook: the harness event (hook entries supply it)
--agent IDnomefor sharing: the agent id (required on a person's login); defaults to yourself on an agent's key
--project-key KEYnofor sharing: the project's sha256, instead of --project-dir
--harness HARNESSnothe harness: claude-code, codex, pi, opencode, hermes, openclaw
--session SESSION_IDnothe harness's id for the session
--progress PROGRESSnothe step it is on, one line of at most 200 characters; empty removes it
--status STATUSnodone, failed, stoppedwith turn-end: how the turn ended
--title TITLEnothe harness's name for the session; empty removes it
--project PROJECTnowhat it works on, such as a repository's name; never a path
--project-dir DIRnothe folder it works in: oo sends its repository's name (unless --project gives one) and a hash of its remote, else of the folder, which its person can share; never the path
--version HARNESS_VERSIONnothe harness's version
--mode MODEnoreport, inject, wakesession receiver mode; report never claims
--wait WAITno0deliver: hold for a database wake, at most 60 seconds
--from SENDERSnodeliver and hook: also admit this person or unbacked agent id
--message MESSAGEnoack or release: the delivered message id
--wakenoClaude Code asyncRewake hook: message on stderr, exit 2

It also takes the connection options.

On this page