🎩 Butler Workspace

The working directory for Jeeves, Peter's digital butler — now powered by Hermes Agent.

        ┌────────────────────────────────┐
        │  Hermes Agent runtime          │   ~/.hermes/
        │  (config, skills, sessions,    │   ← Jeeves's brain
        │   memories, cron, gateway)     │
        └──────────────┬─────────────────┘
                       │ runs commands in cwd
                       ▼
        ┌────────────────────────────────┐
        │  Butler workspace              │   ~/butler/  (THIS REPO)
        │  (docs, scripts, projects,     │   ← Jeeves's desk
        │   committable state)           │
        └────────────────────────────────┘

Two separate things by design:

• ~/.hermes/ — runtime state. Noisy, contains secrets, not git-friendly. Owned by Hermes.
• ~/butler/ (this repo) — durable workspace. Clean, committable, human-readable. Owned by Peter.

The two are linked via Hermes config (terminal.cwd: /home/pti/butler): when Jeeves runs scripts or edits files, this is where it lands.

What's here

Path	Purpose
docs/	Capability documentation, runbooks, and architectural decisions. Start here.
infrastructure-monitoring/	Prometheus/Grafana/Alertmanager stack on lotte (separate repo, vendored as submodule-ish)
scripts/	One-off and recurring scripts the butler invokes (token cost reports, etc.)
memory/	Daily activity notes — YYYY-MM-DD.md raw logs
state/	Persistent runtime state for scripts
legacy/openclaw/	Pre-Hermes (OpenClaw-era) runtime files, kept for reference. See legacy/README.md.
MEMORY.md	Snapshot of Hermes's long-term memory (committable copy of ~/.hermes/memories/MEMORY.md)
IDENTITY.md	Who Jeeves is (name, persona, P.G. Wodehouse inspiration)
HEARTBEAT.md	Operational tasks for heartbeat polling
TOOLS.md	Environment-specific tool notes (Forgejo, Google CLI accounts, etc.)
AGENTS.md	Minimal context for agents working in this directory

Quick links

• 📖 Capability docs: docs/capabilities/ — what Jeeves can do and how
• 🛠️ Operational runbooks: docs/runbooks/ — how to fix/restart/inspect things
• 🤔 Architecture decisions: docs/decisions/ — why we chose X over Y

For agents reading this

If you're an AI assistant working in this directory, read AGENTS.md for the conventions. The big rules:

• ~/.hermes/ is authoritative for runtime behavior; don't duplicate it here.
• Capability docs live under docs/; update them when capabilities change.
• Commit with conventional commits (feat:, fix:, docs:, chore:, refactor:).
• Never commit secrets. Use direnv .envrc (gitignored) for environment variables.

Forge

This repo lives at forge.snamellit.com:pti/butler. Clone via:

git clone forgejo@forge.snamellit.com:pti/butler ~/butler