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.
Claude Code
Claude Code installs OSB through its marketplace subsystem. The
mcpServers block in the bundled .claude-plugin/plugin.json
auto-registers both MCP servers, so there is no explicit
claude mcp add step.
1. Install the plugin
claude plugin marketplace add itechmeat/open-second-brain
claude plugin install open-second-brain@open-second-brain
2. Publish the o2b CLI on PATH
Claude caches the plugin at a versioned path; locate the script:
O2B_SCRIPT="$(find ~/.claude/plugins/cache -path '*open-second-brain*/scripts/o2b' -type f 2>/dev/null | head -1)"
[ -n "$O2B_SCRIPT" ] || { echo "o2b installer not found in Claude plugin cache" >&2; exit 1; }
"$O2B_SCRIPT" install-cli
3. Initialize the vault
o2b init --vault /path/to/vault --name "My Second Brain" \
--agent-name "<chosen-agent-name>" --timezone "<chosen-tz>"
o2b brain init --vault /path/to/vault
o2b init persists vault, agent_name, and timezone into
~/.config/open-second-brain/config.yaml. The auto-registered
servers call o2b mcp with no vault flags; the server reads the
persisted config at spawn time.
4. Verify
o2b doctor --vault /path/to/vault --repo .
claude plugin list
claude mcp list
claude mcp list must show
plugin:open-second-brain:open-second-brain with ✓ Connected.
Run the daily-identity check from install/prerequisites.md.
Native Windows
claude.exe on Windows starts the plugin's MCP servers from
scripts\o2b.cmd. Step 2 above is bun run src\cli\main.ts install-cli
from the plugin directory, and it writes .cmd launchers into
%USERPROFILE%\.local\bin. The lifecycle hooks are POSIX shell commands:
they run when Git for Windows is installed (Claude Code then uses Git
Bash) and are skipped under the PowerShell fallback. See
windows.md.
Lifecycle hooks (auto-enabled)
The bundled hooks/hooks.json registers a PostToolUse hook
(matcher Write|Edit|MultiEdit|apply_patch). To watch the hook
fire end-to-end use
--output-format=stream-json --verbose --include-hook-events.
Machine-enforce write protection (optional)
o2b brain protect --target claudecode --vault /path/to/vault --apply --yes
o2b brain unprotect --target claudecode --vault /path/to/vault
The sidecar manifest at
<vault>/.open-second-brain/protect.lock.json records exactly the
permissions.deny / permissions.allow entries OSB owns.
Update
claude plugin marketplace update open-second-brain
claude plugin update open-second-brain@open-second-brain
Uninstall
claude plugin uninstall open-second-brain@open-second-brain
claude plugin marketplace remove open-second-brain
o2b uninstall --apply-local --remove-cli