Runtime Reference¶
CLI Surfaces¶
- houmao-mgr: Primary management CLI for agents, brains, and server control.
- system-skills: Install and inspect the packaged Houmao-owned skill sets for resolved tool homes.
- houmao-server: HTTP server for session management and TUI tracking.
- houmao-passive-server: Registry-driven stateless server.
- CLI Entrypoints: Module-level entry points and common runtime flags.
Managed-Agent Command Families¶
- agents gateway: Gateway lifecycle and explicit live-gateway request commands.
- agents turn: Managed headless turn submission and inspection.
- agents mail: Managed-agent mailbox follow-up commands.
- agents mailbox: Late filesystem mailbox registration for local managed agents.
- admin cleanup: Registry and runtime maintenance commands.
Build Phase¶
- Launch Overrides: Override system for launch parameters.
- Launch Policy: Policy engine for operator prompt modes and unattended execution.
Run Phase¶
- 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.
Subsystems¶
- Gateway: Per-agent FastAPI sidecar for session control and mail.
- 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.
Other Reference¶
- Claude Vendor Login Files: How Houmao imports
.credentials.jsonand.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.
- Houmao Server Pair: Server + manager pair workflows.
-
Managed-Agent API: Direct agent control API surface.
-
Realm Controller Send-Keys: Raw tmux send-keys control.
- Houmao Server Agent API Live Suite: Server agent API validation.
Developer Guides¶
- TUI Parsing: Shadow parser architecture and maintenance.
- Terminal Recorder: Recording internals.
- Houmao Server Internals: Server-owned TUI tracking.