hermes-agent/website/docs/getting-started
alt-glitch 79e8cd1233 feat(nix): container-aware CLI — auto-route all subcommands into managed container
When container.enable = true, the host `hermes` CLI transparently execs
every subcommand into the managed Docker/Podman container. A symlink
bridge (~/.hermes -> /var/lib/hermes/.hermes) unifies state between host
and container so sessions, config, and memories are shared.

CLI changes:
- Global routing before subcommand dispatch (all commands forwarded)
- docker exec with -u exec_user, env passthrough (TERM, COLORTERM,
  LANG, LC_ALL), TTY-aware flags
- Retry with spinner on failure (TTY: 5s, non-TTY: 10s silent)
- Hard fail instead of silent fallback
- HERMES_DEV=1 env var bypasses routing for development
- No routing messages (invisible to user)

NixOS module changes:
- container.hostUsers option: lists users who get ~/.hermes symlink
  and automatic hermes group membership
- Activation script creates symlink bridge (with backup of existing
  ~/.hermes dirs), writes exec_user to .container-mode
- Cleanup on disable: removes symlinks + .container-mode + stops service
- Warning when hostUsers set without addToSystemPackages
2026-04-11 14:24:29 +05:30
..
_category_.json feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
installation.md feat: add tested Termux install path and EOF-aware gh auth 2026-04-09 16:24:53 -07:00
learning-path.md docs(voice): add comprehensive voice mode guide 2026-03-14 09:50:45 -07:00
nix-setup.md feat(nix): container-aware CLI — auto-route all subcommands into managed container 2026-04-11 14:24:29 +05:30
quickstart.md feat: add tested Termux install path and EOF-aware gh auth 2026-04-09 16:24:53 -07:00
termux.md fix(termux): improve status and install UX 2026-04-09 16:24:53 -07:00
updating.md docs: add post-update validation guidance 2026-04-06 21:26:03 -07:00