brainstack

A production-tested second brain for Hermes Agent: capture, typed memory, retrieval, and nightly consolidation — 14 native skills, a small Python engine, and one brain CLI. All Markdown, no SaaS, no telemetry.

Your agent captures notes, but nothing ever gets consolidated. Notes rot in an inbox, memories are a flat dump of context, links break, and the "brain" forgets what it knew last week. brainstack is the operating system that fixes that: a proven pipeline where every conversation becomes a durable, connected, retrievable memory.

Built and battle-tested in production over months of daily use with Hermes Agent. MIT licensed.

Install (30 seconds)

That's it. The setup script:

• Installs the 14 skills into ~/.hermes/skills/brainstack/ — Hermes loads

them on the next session.

• Scaffolds vault-template/ into your vault (or creates ~/brain-vault).

Non-destructive: existing files are never overwritten.

• Installs the engine to ~/.brainstack/ and links the **brain CLI** into

~/.local/bin.

• Wires the nightly dream-cycle cron (skip with --no-cron).

Useful flags: --vault PATH · --no-cron · --dry-run · --embeddings (real semantic search via a local venv) · --version.

Requirements: Hermes Agent · Python 3.10+ · git · Obsidian optional (it's all plain Markdown).

Upgrade / remove: brain upgrade pulls the latest and re-installs; brain uninstall removes everything except your vault.