Hermes Starter Pack

Cheat-sheet

Every command, config key, and the top gotchas — on one page.

Profiles isolated agents

hermes profile create <name>      # new isolated agent
hermes profile list               # see all
<name> config set model.default anthropic/claude-sonnet-4-6

Each profile = its own config.yaml, .env, SOUL.md, memory & cron. Lives in ~/.hermes/profiles/<name>/.

Run it

hermes                            # start a chat session
hermes model                      # pick / switch model
hermes tools disable browser      # drop tools you don't use (cheaper)
/cost                             # (in session) see token spend
hermes -z "prompt"                # output only — for scripts/cron/CI

Gateway + cron automation

hermes gateway install              # cron only fires while this runs
hermes cron create "0 7 * * *" "your prompt"
hermes cron list | run <id> | pause <id> | remove <id>

Gateway checks every 60s · each job runs in a fresh session · output in ~/.hermes/cron/output/.

Key config keys

KeyWhat it does
model.defaultwhich model the agent uses
model.providerpin provider (avoid surprise routing)
terminal.cwdfolder the agent's tools run in
terminal.home_mode: profilestrict per-profile isolation

Top gotchas

  1. Cron didn't run? The gateway isn't running → hermes gateway install.
  2. "Can't see my files"? Wrong terminal.cwd — point it at the right folder.
  3. Keys in the wrong place. Put them in the profile's .env, not config.yaml.
  4. Docker user? Prefix every command with docker exec hermes.
  5. Cron times are server time, not your local time.

← Back to the Starter Pack