Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript
1.5 KB
Raw Blame
# GITHUB.md

This workspace is durably backed up to **{{GITHUB_REPO_URL}}**. The repository must
remain private.

- **Tracked:** identity files, memory, `brain/`, `skills/`, `state/interview.json`,
  schedules.
- **Ignored:** credentials, local databases, caches, hook state, transcripts,
  machine-specific harness wiring (`.mcp.json`, `.claude/settings.local.json`), and
  anything matching the deny list in `.gitignore`.
- **How it syncs:** `gbrain sources push` — a secret-scan-gated commit + push that
  refuses public remotes. On Claude Code it runs automatically per turn
  (debounced) and at session end via hooks; on Codex or opencode (no wired hook
  system) run it at natural stopping points (the AGENTS.md gate reminds you). If background
  persistence is enabled, a git post-commit hook auto-pushes each commit and a
  30-minute pull job keeps multi-machine checkouts fresh. Run it by hand after
  meaningful changes on any harness.
- **If a push is blocked:** the scan names the file and pattern out loud. Fix or
  allowlist deliberately — never force past it silently.
- **Honest forget semantics:** git history is append-only. Deleting a line from a
  file does not delete it from history; truly removing something requires a history
  rewrite (documented in docs/guides/bootstrap.md). Write accordingly.
- **Recovery:** clone this repo on any machine and run `gbrain bootstrap attach` —
  the body travels; the brain database is rebuilt from `brain/` + re-ingestion.
- Never let valuable work exist only on one machine.