Local-first 🧠memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.
Generic (printout)
Use this target when your runtime is not in the per-runtime list
above. o2b install --target generic never edits any external
config; it prints the canonical MCP server payload and leaves the
operator to wire it into whatever the runtime expects.
Print to stdout
o2b install --target generic --apply --yes --out -
--apply runs the same consent gate as every install lane: an
interactive terminal is shown the payload and asked once, while a
non-interactive run (--json, CI, no TTY) refuses without --yes
(exit code 6) - see
prerequisites.md.
Default format is JSON:
{
"mcpServers": {
"open-second-brain": {
"command": "o2b",
"args": ["mcp", "--vault", "/path/to/vault"],
"env": { "VAULT_AGENT_NAME": "...", "VAULT_TIMEZONE": "..." }
},
"open-second-brain-writer": {
"command": "o2b",
"args": ["mcp", "--writer-only", "--vault", "/path/to/vault"]
}
}
}
YAML is also available:
o2b install --target generic --apply --yes --out - --format yaml
Write to a file
o2b install --target generic --apply --yes --out /path/to/snippet.json
The path is recorded in the sidecar manifest so o2b install --check --target generic can confirm the file still exists.
o2b uninstall --target generic --apply will not delete the
file — the consuming runtime may still depend on it. The
uninstall step prints the path so the operator can clean it up by
hand.
Verify
o2b install --check --target generic
A successful check prints:
o2b install --check
--------------------
generic ok generic: payload written to $HOME/osb-mcp.json (runtime wiring is operator-managed)
$HOME/osb-mcp.json is whatever path --out was given. This block
is asserted against the adapter's real verify() output by
tests/docs/install-verify-conformance.test.ts, so it cannot drift
from the code.
Notes
- Detection always reports
not-installed(there is no canonical config to probe for this target). - The
generictarget is the right escape hatch when a new runtime appears between OSB releases. Per-runtime adapters land in subsequent releases as needed.