Power your agent
Perintah milik penerbit sendiri. Bukan endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code tidak punya tautan instal untuk perintah lokal. Salin perintah di bawah dan jalankan di terminal.
claude mcp add oh-my-second-brain -- npx -y oh-my-second-brain@0.21.0Jalankan di terminal.
{ "mcpServers": { "oh-my-second-brain": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BukaDari penerbit
Oh My Second Brain: a host-agnostic, user-owned convention layer for Obsidian and plain-markdown knowledge vaults.
| Start with lexical retrieval. Choose vector, HyDE, query expansion, or reranking when you need them. |
| Define what your folders and properties mean. Supported write paths check the contract and report their findings. |
| Keep your existing notes and templates. Connect Claude Code, Codex, and Hermes to the same vault. |
Search and oms doctor status stay read-only. Index maintenance is explicit.
Requires Node.js 20 or later and an existing Obsidian or Markdown vault. Replace /path/to/vault with your vault's absolute path.
npm install -g oh-my-second-brain
oms --help
Run setup in your terminal. The interview covers folders and properties, then seals the contract. Existing notes are not modified.
oms setup --vault /path/to/vault
oms setup status --vault /path/to/vault
Install the integration for the host you use:
oms setup host install --runtime claude --vault /path/to/vault --yes
Replace claude with codex or hermes; use all to install all three. For Claude Code, add --execute to let OMS add the plugin marketplace and run claude plugin install oms@oh-my-second-brain, which brings the /oms:* skills; without it, OMS prints the exact commands for you to run. Host integration is optional if you only need the CLI. See the installation guide for Hermes profiles, model setup, and removal.
# Build the derived search index explicitly.
oms doctor sync-embeddings --mode sync --vault /path/to/vault
# Start with lexical search. No vector model required.
oms search "project decisions" --vault /path/to/vault
Try asking your connected agent:
Find my notes about this project and surface the decisions I have already made.
Check this note against my vault contract and show me what needs attention.
Suggest related notes I could link to, without changing any files.
These are example requests, not captured run results. Available workflows and write enforcement differ by host as described below.
You define the meaning. Your agent writes the content. OMS checks the structure.
[!IMPORTANT] Set up the contract before relying on write checks. A vault with no seal on this machine is not contract-judged: its writes carry a
contract-openwarning namingoms interview, and general path and input safeguards still apply. A write that breaks the contract is saved with warnings; a safety refusal, a missing or staleifMatch, or an unverified target leaves the file unchanged. An allowed write with no warnings means structural compliance, not factual accuracy or quality approval.
.oms/settings.json holds version, vaultId, templateFolder, embedding, and agentRepair. Other .oms/ entries are ignored and reported as unexpected control files by oms doctor contract. .obsidian/types.json is a read-only observation, not an override of the seal.templateFolder and are never sealed or judged. A new note is scaffolded from the live template: the one the write names, or else the one template whose basename or folder: key matches the target folder. OMS never rewrites or copies a template file, and does not parse or execute Templater, JavaScript, or a private token language. A write only fills what is mechanical in the note being written: {{title}}, {{date}} and {{time}} variables, date and datetime defaults on a new note, and the chosen template's frontmatter defaults and missing headings. The note's own values win. It never invents a required value; only a value the contract fixes is filled, as a lossless fix listed in the receipt's fixes.oms setup status counts its template constraints as legacyTemplates, and they are reported, never enforced.{field, kind} warnings, and a refused write returns its reason the same way. Each of these comes with one guidance command, never rule values, store paths, or the contract body..oms/settings.json no longer matches this machine's seal, writes are refused as contract-tampered; oms doctor contract explains it. Missing or broken seal evidence is contract-unreadable: the write is saved with that warning until the owner reseals with oms interview. When oms doctor contract finds a moved vault or a missing or unreadable index entry, it names oms doctor contract --fix, which reindexes without resealing. A machine with no seal is a different case: its vault is not contract-judged.See architecture, conventions, and ADR-007.
oms setup in a terminal runs the interactive interview and seals the contract. oms interview is the same terminal interview on its own command; it requires a terminal and refuses to run under OMS_NON_INTERACTIVE=1.
The setup skill asks the owner each question via oms setup --questions and submits answers with oms setup --answers <file|->. This path can seal a first or stricter contract; a loosening reseal stays with the owner's terminal. The MCP interview tool continues the interview across calls: op: questions is read-only, and answer, confirm, and seal record to the interview log on a verified target. It seals only the proposal the owner confirmed and never reclaims a stale seal lock.
Setup and the interview ask about folders and properties only. oms setup extract --template <name> previews what a template in templateFolder would scaffold: its source, folder: selector, property names, and headings. Editing a template takes effect on the next write without a reseal.
oms doctor contract diagnoses seal problems, stale locks, orphaned generations, unexpected control files, and hook transport failures. Its --fix only re-indexes a moved or unindexed vault, or rebuilds an unreadable index. Other broken seals are resealed with oms interview.
Model lifecycle is separate: oms setup model install|select|waive|status.
One domain kernel, with host-native integrations.
write · search · interview · doctor
The six skills are distill, doctor, interview, search, setup, and write.
distill and setup are tool-less workflows; MCP seals only through interview op: seal on a proposal the owner confirmed. Detail capabilities use op values under the four tools. Tool annotations are per tool: only search is marked read-only, because write and the doctor repairs mutate and interview is kept conservative.
[!NOTE] Claude's hook denies a write only on a safety refusal: a control or unsafe path (including access under
~/.oms/), unsupported input, or a tampered contract. A contract finding allows the write with a warning; a hook that cannot run allows the write and logs a warning. Native file writes in Codex and Hermes do not pass through the OMS judge. This is not a filesystem-wide sandbox.
Host installation stores a signed maintenance pointer at ${XDG_CONFIG_HOME:-~/.config}/oms/vault.json and stamps oms serve mcp --vault /path/to/vault into managed host entries. Only oms setup host install|remove|sync|status use that pointer to maintain integrations.
Runtime target resolution does not read it. Precedence is explicit target → local vault controls → bridge → OMS_VAULT → current directory. The current-directory fallback is read-only: sealing, note writes, and derived-state repair cannot use it.
oms setup package update updates the package only. Run oms setup host sync separately to synchronize installed host assets. See verified targets.
Lexical by default. Additional retrieval channels by choice. Search includes notes that fail the contract; a missing or damaged contract does not stop retrieval.
Missing, incomplete, or uninstalled model selections fail loudly rather than silently switching to another capability. These are available retrieval options, not a claim of parity or superiority over another engine.
Use oms search --context for structured context and oms search --path <note> to read one note exactly. Indexing is explicit: oms doctor sync-embeddings --mode sync|embed|repair selects one of three distinct modes. See the CLI map for all operations.
oms is the short alias of oh-my-second-brain, with seven CLI families. 0.19 replaced the 0.18 families; see the 0.19 migration guide.
oms search <text> Search notes; lexical by default
oms search --path|--context|--link Read one note, gather context, or suggest links
oms interview Interview the vault owner in a terminal and seal
oms write <path> Save a note from stdin when the contract allows it
oms setup Seal the contract (--questions/--answers for agents)
oms setup extract|status Preview a template scaffold or the contract posture
oms setup host install|remove|sync|status Manage host assets and MCP registrations
oms setup model install|select|waive|status Manage local model selection
oms setup package check|update Check or update the OMS package
oms setup bridge add|remove|status Manage repository-to-vault bridges
oms doctor status Show read-only vault health
oms doctor contract|audit|link-check Diagnose the contract, notes, or wikilinks
oms doctor sync-embeddings|cleanup|build-graph Maintain the derived index and graph
oms serve mcp|http Start the MCP or local HTTP server
oms hook pre Judge a Claude write against the contract
Every recognized command accepts --help and -h, exits 0, and has no side effects. An unknown command combined with --help exits 1. A family removed in 0.19 exits 1 and names its replacement.
oms doctor audit reports {path, field, kind} entries without rewriting notes. Notes are written as whole content through oms write <path> < note.md or MCP write {path, content, template?, ifMatch?, check?}; both take the same write pipeline, and template optionally names the template in templateFolder that scaffolds a new note. Overwriting an existing note needs ifMatch (--if-match) with its current sha256: revision; check (--check) judges without touching disk. An allowed write returns a receipt with the new revision and updates the keyword index of an existing engine store in the same call, so the note is searchable at once. There is no completion call or reviewer conversation.
oms doctor cleanup removes eligible derived state. oms doctor build-graph rebuilds the note graph.
Note create, append, update, and backfill are retired operations. There is no link apply, note renderer, or compatibility path for those retired operations.
Contributions are welcome. Start with the contributing guide, or open an issue with a reproducible problem or a focused proposal.
ACKNOWLEDGMENTS records design influences, including Ouroboros and Gajae Code's deep-interview. Those credits describe ideas, not a copied runtime or a research result. The hero is an original Blender library scene with floating paper and knowledge-stars. Artwork and material credits describe its native rendering, CC0 wood texture, and typography. It is conceptual artwork, not a product screenshot, host-smoke evidence, or a product-gate result.
Oh My Second Brain: a host-agnostic, user-owned convention layer for Obsidian and plain-markdown knowledge vaults.
{ "mcpServers": { "oh-my-second-brain": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
Oh My Second Brain berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-10-28. Oh My Second Brain: a host-agnostic, user-owned convention layer for Obsidian and plain-markdown knowledge vaults.