Runtime Reference¶

CLI Surfaces¶

houmao-mgr: Primary management CLI for agents, brains, projects, credentials, mailbox, and local workflow control.
system-skills: Install and inspect the packaged Houmao-owned skill sets for resolved tool homes.
houmao-passive-server: Maintained registry-driven API server for discovery, observation, request submission, gateway proxying, mail proxying, and managed-headless agents.
CLI Entrypoints: Module-level entry points and common runtime flags.

scoped agents gateway: Gateway lifecycle and explicit live-gateway request commands.
scoped agents turn: Managed headless turn submission and inspection.
scoped agents mail: Managed-agent mailbox follow-up commands.
scoped agents mailbox: Late filesystem mailbox registration for local managed agents.
admin cleanup: Registry and runtime maintenance commands.

Launch Overrides: Override system for launch parameters.
Launch Policy: Policy engine for operator prompt modes and unattended execution.

Launch Plan: Composing manifest + role into a backend-specific plan.
Session Lifecycle: Start, resume, prompt, and stop sessions.
Backends: Backend model and per-backend notes.
Role Injection: Per-backend role injection strategies.
Managed Launch Prompt Header: Houmao-owned prompt header prepended to every managed launch by default — content, composition order, opt-out flags, and stored launch-profile policy.

Gateway: Per-agent FastAPI sidecar for session control and mail.
Notifier-Prompt-Driven Loop Runtime: Mail-driven loop model where notifier prompts wake agents, event skills process mail, tick skills run once from prompt turns, and agents must not wait in-chat.
Mailbox: Unified mailbox protocol — filesystem and Stalwart JMAP.
TUI Tracking State Model: Tracked state, signals, and transitions.
TUI Tracking Detectors: Detector profiles and registry.
TUI Tracking Replay: State reducer and replay engine.
Completion Detection: Turn-anchored readiness and completion pipelines.
Agent Registry: Session discovery and managed agent records.
Terminal Record: tmux session recording and replay.
System Files: Filesystem layout and owned paths.

Claude Vendor Login Files: How Houmao imports .credentials.json and .claude.json, and how to validate that lane locally.
Release Publishing: PyPI trusted publishing setup and the GitHub release flow.
Realm Controller: Runtime session orchestration.
Passive Server API: Maintained API-based coordination for running agents.
Managed-Agent API: Direct agent control API surface.
Realm Controller Send-Keys: Raw tmux send-keys control.
Houmao Server Pair: Historical old-server pair notes for recognizing retired workflows.
Houmao Server Agent API Live Suite: Historical old-server API validation notes.