GITHUB.md
This workspace is durably backed up to (not yet created — bootstrap repo sets this). 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 frombrain/+ re-ingestion. - Never let valuable work exist only on one machine.