Skip to content

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.

TypeScript
2.3 KB
Raw Blame

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 generic target is the right escape hatch when a new runtime appears between OSB releases. Per-runtime adapters land in subsequent releases as needed.