Use to operate a running Intendant daemon from the CLI — sessions, approvals, displays and screenshots, computer-use input, browser workspaces, audio, and federated peers (message or delegate to another machine's agent, or drive its screen directly with --peer). Prefer `intendant ctl` over broad MCP tools to keep model context small.
Keyless end-to-end smoke for operator goals on a NATIVE session — drives a mock-provider intendant over the control socket and proves set/get/notice-injection/clear/honest-failure
Keyless end-to-end smoke for the session-vitals git + cache segments — mock-provider daemon in a scripted git repo, asserts the merged session_vitals event on the control socket (branch/dirty/ahead/parity plus cache hit/TTL)
Use when investigating Intendant run history, session logs, dashboard replay/search behavior, external-agent wrapper logs, Codex/Claude backend logs, context rewind/fission sidecars, display frames, recordings, or task artifacts under ~/.intendant/logs. Teaches how to find sessions, search session.jsonl and sidecars, follow turn-file byte spans, map wrapper sessions to backend ids, and interpret what each log artifact provides.
E2E test the display recording and replay system. Launches intendant --web with recording enabled, triggers Xvfb display creation, verifies ffmpeg recording starts, segments are created and serveable, and the replay UI loads in the browser. Asserts via /recordings and /debug HTTP endpoints. Human monitors via VNC on port 5950.
E2E test the live audio pipeline with real audio. Uses espeak-ng TTS + PulseAudio virtual mic to feed synthesized speech to Gemini Live or OpenAI Realtime through the browser's getUserMedia on /app. Asserts via /debug endpoint JSON. Human monitors via VNC on port 5950. Tests the full audio path: TTS -> virtual mic -> Firefox -> AudioWorklet -> WASM -> live model -> tool calls -> agent.
E2E test the --web app UI. Launches Xvfb, runs intendant --web as a background process, opens Firefox on /app, and asserts via /debug endpoint and WebSocket JSON. Human monitors via VNC on port 5950.
Live end-to-end test of the Claude Code external-agent integration: spawn a supervised Claude Code session in a toy repo, exercise the approval protocol (allow + deny), native session-id capture, mid-turn steering, interrupt, thread actions (/compact, fork via --fork-session), the async Agent-tool sub-agent surfacing (ephemeral task-* child sessions), and resume-by-native-id, driving everything through the Unix control socket.