human live

LiveSession CLI — interruptible, governed conversation from the terminal

Terminal control for LiveSession — the launch public API for live human–agent interaction. Same operations as Companion and MCP (human.live.*).

Guide: Live Interaction Layer

---

Prerequisites

human login
human doctor   # confirms delegation token is live
export HUMAN_API_URL=https://api.haio.run   # or local :3001

---

Commands

`human live start`

Open a text or voice LiveSession.

human live start --mode text --agent did:agent:companion
human live start --mode voice --provider mock

Flag	Description
`--mode`	`text` (default), `voice`, or `multimodal`
`--provider`	`mock`, `personaplex`, `openai-realtime`, …
`--agent`	Agent DID (defaults to delegation target)

Maps to `POST /v1/live/sessions`.

---

`human live status`

Show session projection: presence, work run state, active intent.

human live status --session live_sess_abc123

Maps to GET /v1/live/sessions/:id and /projection.

---

`human live stop`

Close a session and release resources.

human live stop --session live_sess_abc123

Maps to DELETE /v1/live/sessions/:id.

---

`human live override`

Platform override — reflex-backed; agents cannot veto.

human live override --session live_sess_abc123 --utterance "stop"
human live override --session live_sess_abc123 --capability live.session.cancel_pending

Capability	Aliases
`live.session.stop_speaking`	stop, be quiet
`live.session.cancel_pending`	don't send, cancel that
`live.session.show_status`	what are you doing
`live.session.show_receipt`	who approved that, prove it

Maps to `POST /v1/live/sessions/:id/override`.

---

`human live test-intent`

Propose or supersede an intent hypothesis (developer smoke test).

human live test-intent --session live_sess_abc123 \
  --goal "Prep for investor call"

human live test-intent --session live_sess_abc123 \
  --goal "Focus on investor challenges" \
  --supersede hyp_prev_id

Maps to POST /v1/live/sessions/:id/intent.

---

Example session

SESSION=$(human live start --mode text --json | jq -r .live_session_id)

human live test-intent --session "$SESSION" --goal "Summarize inbox"
human live status --session "$SESSION"
human live override --session "$SESSION" --utterance "pause"
human live stop --session "$SESSION"

---

human live

Prerequisites

Commands

human live start

human live status

human live stop

human live override