Every conversation session archived as clean Markdown, automatically secret-scrubbed, tracked for token telemetry, and staged for human review. No black boxes. No vendor lock-in. Native Obsidian power with built-in MCP server support.
How volatile agent conversations transform into durable, human-verified knowledge without hallucinating or leaking secrets.
Your agent now remembers why you decided things, your vault has a local undo history, and cron noise stays out of your real chat logs.
03-Resources/Axioms.md
The few beliefs everything else derives from
03-Resources/Principles/
Standing rules distilled from repeated decisions
03-Resources/Decisions/
Hard-to-reverse choices, with alternatives rejected
Log hard-to-reverse choices from Decisions/TEMPLATE.md. The Alternatives Rejected section is mandatory, so agents stop re-proposing ideas you already ruled out. Axioms.md ships empty on purpose: it should hold your beliefs, not generic filler.
Hook session_git_snapshot.py into Hermes' on_session_end and every session gets its own commit you can git diff or revert. Local history only: it never pushes or fetches. A secret-scanning gate blocks the commit if anything looks like an API key or private key, and logs only the file path, never the content.
Cron logs, lock files and cron-run session notes now live in 04-Archives/Cron/, so Daily/ holds only your real chats. Upgrading? migrate_cron_sessions.py moves old cron notes over and is safe to re-run.
The installers now finish by running verify_install, which sanity-checks vault structure, plugins, the MCP server and the memory pipeline, so problems show up on day one instead of week three.
Scripts are grouped into beginner, analyst, poweruser and experimental packs under _System/Scripts/features/. Start with the core and copy in more when you're ready.
template_drift.py compares your vault to the latest template release by SHA-256 and sorts every file into safe, customized, outdated or missing, so you know exactly what an update will touch.
promote_memory.py --review walks you through pending candidates one by one: promote to MEMORY.md or your User Profile, dismiss, or skip. Every action lands in the consolidation audit log.
dream_cycle.py was rebuilt as an autonomous reflection engine that consolidates memories between sessions, and now ships with its own test suite.
Test any architecture decision or tool directive against Hermes Brain's 4 peer review personas before committing it.
Tune your agent's behavioral dials in real time. Generates a calibrated User-Profile.md alignment block.
02-Areas/User-Profile.md Block
● Live Reactive
Inspect and 1-click copy the production Markdown templates bundled in _System/Templates/.
Loading template...Explore real note connections across Projects, Areas, Resources, and Archives directly in your browser.
Compare the context window token overhead of naive chat log dumping vs Hermes Brain's human-staged fact memory.
04-Archives/Memory-Review/ extracts durable knowledge while discarding 92% of transient chat noise from prompt tokens.
Organized for discoverability, speed, and effortless agent context ingestion. Explore the directory hierarchy below.
Contains active initiatives with concrete deadlines and deliverables. Includes Architectural Decision Records (ADR) with 4-agent peer review personas (Argus for security, Codex for code, Ledger for token efficiency, Vox for human alignment).
hermes_brain_mcp.py)Expose your Obsidian second brain directly to Claude Desktop, Cursor, OpenClaw, and any MCP-compatible client over stdio.
Click any tool below to test the simulated stdio JSON-RPC request and see the real-time response payload:
"hermes-brain": {
"command": "python",
"args": ["<vault_path>/_System/Scripts/hermes_brain_mcp.py"]
}
Choose the setup option that fits your workflow — from a 1-paste chat prompt to an interactive terminal script.
Downloads the latest template, asks where you want your vault, checks for Obsidian, registers HERMES_VAULT_PATH, then runs verify_install to confirm the vault structure, plugins, MCP server and memory pipeline are all wired up.
irm https://raw.githubusercontent.com/mistrysiddh/hermes-brain-template/main/_System/Scripts/Installers/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/mistrysiddh/hermes-brain-template/main/_System/Scripts/Installers/install.sh | bash
Hermes will clone the repo, run the installer, configure the environment, and wire up the hourly archiving cron job automatically.
Clone https://github.com/mistrysiddh/hermes-brain-template into a new "Hermes Brain" vault for me. Steps: 1. Ask me where I want the vault folder to live (default: ~/Hermes Brain on Linux/macOS, or %USERPROFILE%\Hermes Brain on Windows). 2. Clone the repo into that location. 3. Run the platform-appropriate installer (_System/Scripts/Installers/install.sh or install.ps1). 4. Relay any questions to me and confirm env.HERMES_VAULT_PATH is set. 5. Create an hourly session-archiving cron job named "hermes-brain-archive-hourly" pointing to <vault>/_System/Scripts/hourly_archive.py. 6. Show me the verify_install results and fix anything it flags.
Use GitHub's green "Use this template" button to fork the repository privately into your GitHub account, then clone it locally:
git clone https://github.com/mistrysiddh/hermes-brain-template.git "Hermes Brain" cd "Hermes Brain" # Windows: powershell -ExecutionPolicy Bypass -File .\_System\Scripts\Installers\install.ps1 # Linux/macOS: chmod +x _System/Scripts/Installers/install.sh && ./_System/Scripts/Installers/install.sh
Creates a temporary copy in %TEMP% or /tmp without touching your real Hermes config or permanent directories:
# Linux / macOS: ./_System/Scripts/Installers/try.sh # Windows (PowerShell): powershell -ExecutionPolicy Bypass -File .\_System\Scripts\Installers\try.ps1
Spin up a fully configured Linux container in your browser with zero local installs:
Launch Codespaces Sandbox04-Archives/Daily/, candidate reviews in 04-Archives/Memory-Review/, and plugin configs are strictly git-ignored so you never accidentally commit personal data.
./_System/Scripts/Installers/update.sh (or update.ps1 on Windows). It pulls the latest scripts, templates, and bug fixes without touching your existing personal notes, daily logs, or user profiles. Want to see what would change first? Run python _System/Scripts/template_drift.py "<vault-path>" to get a report of which files are safe, customized, outdated or missing.
_System/Scripts/session_git_snapshot.py in as a Hermes on_session_end hook. It commits a local snapshot of the vault after every session (creating a local-only repo on first run), so a bad multi-file edit is one git revert away. It never pushes or fetches, and it refuses to commit if it spots something that looks like a secret.
04-Archives/Cron/sessions/ so Daily/ only holds real conversations and your Dataview queries stay clean. Upgrading from an older vault? Run python _System/Scripts/migrate_cron_sessions.py --vault "<vault-path>" once (add --dry-run to preview) to move the existing ones.