Retired Houmao Server Pair¶
This page is historical reference only. The former houmao-server + houmao-mgr server ... pair is retired as a public operator workflow, and the package no longer installs a standalone houmao-server executable.
Use the maintained surfaces instead:
What Replaced It¶
houmao-mgr remains the primary local management CLI for project overlays, agent launch and join, gateway attach, mailbox workflows, credentials, cleanup, and system-skill installation.
houmao-passive-server is the maintained server/API authority. It discovers running agents from the shared registry, observes local tmux-backed agents, proxies to attached gateways, exposes mailbox and memory proxy routes, and can own native headless agents with durable turn records.
Retired Surfaces¶
The following old surfaces are no longer maintained public workflows:
houmao-serveras a packaged executablehoumao-mgr server start|status|stop|sessions ...houmao-clihoumao-cao-server- standalone
/cao/*compatibility routes - new runtime manifests with
backend = "houmao_server_rest"
Some Python modules under src/houmao/server/ remain importable because maintained manager and passive-server code still use shared models, compatibility records, TUI helpers, or managed-headless storage shapes. That module location is internal support only and does not imply a supported standalone server product.
Migration Guide¶
Use these replacements for current workflows:
| Old intent | Maintained path |
|---|---|
| Start the server API | houmao-passive-server serve --port 9891 |
| Launch a local managed agent | houmao-mgr project agents launch ... |
| Adopt an existing tmux agent | houmao-mgr agents self join ... |
| Attach or inspect a gateway on the owning host | houmao-mgr agents single ... gateway ... or houmao-mgr agents self gateway ... |
| Inspect or prompt through a server API authority | houmao-mgr agents single ... state|prompt|mail|turn ... --port 9891 or passive-server /houmao/agents/* routes |
| Manage passive-server-owned headless turns | houmao-mgr agents single ... turn ... --port 9891 or /houmao/agents/{agent_ref}/turns |
| Recognize old server filesystem artifacts | Retired Houmao Server Filesystem Notes |