houmao-mailbox-mgr

Manage Houmao filesystem mailbox roots, accounts, and agent bindings.

18|3|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/igamenovoer/houmao --skill houmao-mailbox-mgr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: houmao-mailbox-mgr
Source: https://github.com/igamenovoer/houmao/tree/main/src/houmao/agents/assets/system_skills/houmao-mailbox-mgr
Command: npx skills add https://github.com/igamenovoer/houmao --skill houmao-mailbox-mgr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Houmao mailbox administrations require careful filesystem mailbox-root lifecycle and account/structure maintenance to prevent broken mail delivery state, stale indexes, and incorrect agent mailbox bindings.

Core Features & Use Cases

  • Mailbox-root lifecycle management: initialize, inspect, repair, cleanup, clear delivered messages, and export filesystem or project mailbox roots.
  • Manual mailbox-account administration: register, inspect, unregister, and clean mailbox accounts under a selected root.
  • Structural mailbox inspection: list, inspect, or clear projected message structure for a mailbox address (structural projections, not actor-scoped unread state).
  • Late local managed-agent binding: register, inspect, or remove late filesystem mailbox bindings for an already-running local managed agent.
  • Use case example: If a project mailbox root has invalid index state or corrupted delivered-message projections, run repair first, then export an archive for offline review while keeping account registrations intact.

Quick Start

Ask the AI to initialize and validate your project mailbox root and show its current status by running: houmao-mailbox-mgr project mailbox status

Frequently Asked Questions about houmao-mailbox-mgr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I repair a corrupted filesystem mailbox root and export the messages?

To repair a corrupted filesystem mailbox root, run repair first to fix invalid index state, then export an archive for offline review. This keeps account registrations intact while resolving stale indexes and broken delivery state.

What is the best way to manage mailbox accounts under a selected root?

Manual mailbox-account administration lets you register, inspect, unregister, and clean mailbox accounts under a selected root. This ensures proper account maintenance and prevents incorrect agent mailbox bindings within the CLI lanes.

How do I bind a filesystem mailbox to an already running local managed agent?

Late local managed-agent binding allows you to register, inspect, or remove filesystem mailbox bindings for an already-running local managed agent. This handles post-launch mailbox binding maintenance safely.

Can I inspect and clear structural message projections for a specific mailbox address?

Yes, structural mailbox inspection allows you to list, inspect, or clear projected message structure for a mailbox address. This targets structural projections specifically, not the actor-scoped unread message state.

Does this mailbox administration tool require any specific dependencies to run?

No dependencies are required. The tool uses a single launcher resolved for the workspace, checking PATH first with a uv fallback, and enforces read-only help gating alongside lane-specific routing boundaries.