hermes-agent/website/docs/user-guide
Teknium e95e13783b fix(docker): per-session container isolation and session-scoped workspace mounts
Two bugs reported on the docker terminal backend (desktop app, sandboxed
profiles with container_persistent: false):

1. A NEW chat's container inherited the PREVIOUS session's workspace,
   bind-mounted rw at /workspace, because the mount source was the
   process-global TERMINAL_CWD env var (written by the workspace picker,
   outliving its session) and all sessions shared one 'default' container.

2. Every command failed with exit 126 because the desktop gateway recorded
   the HOST launch directory as the session cwd, and each command was
   prefixed with 'cd /Users/<user>/...' inside the container.

Fixes (class-wide, single owners):

- container_persistent: false + docker now keys containers PER SESSION:
  fresh container per chat, removed at session close/idle. delegate_task
  children share the parent's container via an explicit alias registry.
  container_persistent: true keeps the documented ONE-long-lived-container
  contract unchanged.
- _resolve_task_host_cwd() is the single owner of the cwd->/workspace mount
  policy across all four env-creation sites; under isolation it refuses
  process-global cwd sources and mounts only the session's own attached
  workspace (tui_gateway now tags overrides with cwd_source).
- _resolve_command_cwd() gains the same host-path guard the env-creation
  sites already had (#50636/#54447 sibling site): a recorded host cwd is
  discarded on container backends instead of cd-ing every command into a
  nonexistent path.

E2E-tested against real Docker: distinct containers per session, no stale
mount in a fresh session, no exit 126 from host cwd records, containers
removed at session teardown.
2026-08-09 14:35:02 -07:00
..
egress
features fix(personality): single-owner personality state + one-time reset migration 2026-08-09 10:33:58 -07:00
messaging docs(telegram): explain rich draft final delivery 2026-08-08 17:15:45 -07:00
secrets
skills feat(tests): CI-enforce skill authoring standards; clear all remaining debt 2026-08-08 15:43:00 -07:00
_category_.json
checkpoints-and-rollback.md
cli.md feat(cli): show session titles in status bars 2026-08-08 17:02:55 -07:00
configuration.md fix(docker): per-session container isolation and session-scoped workspace mounts 2026-08-09 14:35:02 -07:00
configuring-models.md
desktop.md
docker.md
git-worktrees.md
import-from-other-agents.md
managed-scope.md
multi-profile-gateways.md
profile-distributions.md
profiles.md docs: warn against pointing two agents at one Hermes home (memory, profiles, FAQ) 2026-08-05 21:33:44 +05:30
security.md
sessions.md feat: --resume latest keyword and --in DIR launch flag 2026-08-08 04:03:41 -07:00
tui.md feat(cli): show session titles in status bars 2026-08-08 17:02:55 -07:00
which-file-does-what.md docs: add 'Which File Does What?' - one-page map of SOUL/USER/MEMORY/AGENTS 2026-08-05 21:33:44 +05:30
windows-native.md docs: fix stale PATH location in windows-native common pitfalls 2026-08-05 21:33:44 +05:30
windows-wsl-quickstart.md