sbx/hermes-agent-sessions repository overview

⁠Hermes Agent host sessions for Docker Sandboxes

This v3 mixin Kit retains Hermes Agent conversation state and agent-authored resources on the host across sandbox removal. It composes with either the Hermes Agent workload or its agent mixin.

This Kit is built on Docker Hardened Images.

⁠Run

sbx run sbx/hermes-agent:latest --kit sbx/hermes-agent-sessions:latest /path/to/workspace

⁠Kit arguments

This kit has no create-time kit arguments.

⁠Authentication and configuration

The runtime mounts host storage at /home/agent/hermes-history. Each sandbox uses a subdirectory named after that sandbox, so simultaneous sandboxes do not share one writable session store. Reuse the sandbox name to reconnect to its retained state.

The kit retains the declared session data, not account credentials or the agent's complete configuration directory. Conversation history can contain workspace content and tool output. Authentication stays with the composed agent kit.

The install hook refuses to replace existing nonempty session state or unexpected symlinks. Move existing state into the host-backed directory before adding this mixin to an existing environment.

⁠Related kits

• sbx/hermes-agent⁠ provides the complete agent workload.
• sbx/hermes-agent-mixin⁠ provides the agent overlay for a compatible workload.

⁠Source and security

For the Kit format and capability contracts, see the Sandbox Kit v3 specification⁠.

For runtime setup, see the Docker Sandboxes documentation⁠. For provenance, SBOM, VEX, and image verification, see the Docker Hardened Images documentation⁠.

Hermes Agent is a project of Nous Research. Product names and logos do not imply sponsorship or endorsement.