Skip to content

Hermes Agent data directory structure (~/.hermes/)

The ~/.hermes/ directory is the central data repository for the Hermes Agent system.^[001-TODO__Hermes_HUD_UI_-AI_Agent_网页监控面板.md] It serves as the persistent storage layer where the agent's state, memory, configuration, and operational history are maintained.^[001-TODO__Hermes_HUD_UI-_AI_Agent_网页监控面板.md]

Because this directory acts as the "source of truth" for the agent's activity, monitoring tools and user interfaces—such as the Hermes HUD UI—connect directly to it rather than relying on intermediary APIs or logs.^[001-TODO__Hermes_HUD_UI_-_AI_Agent_网页监控面板.md]

Data access & monitoring

The ~/.hermes/ directory enables real-time monitoring of the agent's "consciousness." Both the Terminal User Interface (TUI) and the Web-based HUD UI access this location to visualize the agent's internal state.^[001-TODO__Hermes_HUD_UI_-_AI_Agent_网页监控面板.md]

Monitoring tools utilize the data within this directory to display Metrics across various dimensions, including: * Memory & Identity: Persistent memory storage and user profiles.^[001-TODO__Hermes_HUD_UI_-AI_Agent_网页监控面板.md] * Operational Costs: Token consumption and spending Metrics tracked by model.^[001-TODO__Hermes_HUD_UI-AI_Agent_网页监控面板.md] * Activity & Health: Status updates, interaction history (Sessions), and system health checks.^[001-TODO__Hermes_HUD_UI-_AI_Agent_网页监控面板.md]

Usage prerequisites

For interfaces like the Hermes HUD UI to function correctly, the ~/.hermes/ directory must exist and contain valid agent data.^[001-TODO__Hermes_HUD_UI_-AI_Agent_网页监控面板.md] This implies that the Hermes Agent core system must be initialized and have run at least once to generate the necessary file structure and initial state.^[001-TODO__Hermes_HUD_UI-_AI_Agent_网页监控面板.md]

  • Hermes HUD UI: A web interface that reads directly from this directory to visualize agent status.
  • Hermes Agent: The underlying AI agent framework that generates the data.

Sources

  • 001-TODO__Hermes_HUD_UI_-_AI_Agent_网页监控面板.md