Skip to main content
HUMΛN

human live

human live

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"

See also

← All CLI commands