sbx/docker-agent-sessions repository overview

⁠Docker Agent host sessions for Docker Sandboxes

This Docker Hardened Images mixin retains Docker Agent conversation state on the host across sandbox removal. It composes with either the Docker Agent workload or its agent mixin.

⁠Run

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

Use a versioned tag from the Tags tab to pin this kit release. The sbx/docker-agent-sessions tags mirror the corresponding dhi/docker-agent-sessions tags after a successful build.

⁠Authentication and configuration

The runtime mounts host storage at /home/agent/docker-agent-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/docker-agent⁠ provides the complete agent workload.
• sbx/docker-agent-mixin⁠ provides the agent overlay for a compatible workload.

⁠Source and security

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

Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. Product names and logos do not imply sponsorship or endorsement.