obsidian-second-brain plugin
Persistent agent memory in an Obsidian vault: saving decisions, search, research and background vault upkeep
- 5,025 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Rewrites vault notes and runs background agents
- Sends requests to external APIs when research commands are used
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/obsidian-second-brainDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Rewrites vault notes and runs background agents
- Sends requests to external APIs when research commands are used
This is third-party code. Review the repository files before installing.
What it does
The plugin turns an Obsidian vault into shared memory for Claude Code and other agents. The save command splits a conversation into decisions, people, tasks and ideas and files them into the right notes, while search and context loading spare you re-explaining projects each session. New sources, from links and PDFs to voice memos and screenshots, rewrite existing pages, and a separate command reconciles contradictions. A research toolkit uses Perplexity, Grok, YouTube and free sources, and background agents handle a morning brief, nightly cleanup and weekly review.
Who it is for. For developers, founders and researchers who keep notes in Obsidian and want the agent to remember context across sessions.
Good fit when
- You are tired of re-explaining projects and decisions to the agent
- You need meeting and conversation outcomes saved as structured notes
- You want topic research collected straight into your knowledge base
Not a fit when
- You do not want the agent rewriting existing notes on its own
- The vault holds data that must not go to external APIs
Example request
Save the outcomes of this meeting to the vault: decisions, people and tasksLimitations
Needs git and uv, plus jq for the script install. Core commands work without keys, but X, Perplexity, NotebookLM and extended YouTube need xAI, Perplexity, Gemini and YouTube keys, some paid. Audio transcription installs Whisper with PyTorch. There are many commands, namespaced in plugin mode.
How to disable. Remove the plugin via /plugin and delete OBSIDIAN_VAULT_PATH from ~/.claude/settings.json. For the script install, delete ~/.claude/skills/obsidian-second-brain and the registered hook.
FAQ
Do I need API keys?
Not for core vault commands. Keys are only needed for some research commands, and /research falls back to free sources without one.
Does it work with other agents?
Yes, build.sh produces builds for Codex, Gemini CLI, OpenCode and others.
Discussion
No questions or reviews yet.
Related
PluginsAn Obsidian vault template with hooks, commands and skills that gives Claude Code, Codex and Gemini CLI persistent memory across sessions
An Obsidian vault template with 18 skills, 72 commands and 6 subagents for Claude Code: the agent turns sources into linked pages and answers from them
A plugin and skill set that turns an Obsidian vault into a knowledge base with sources, links and grounded answers
Four skills for a personal Obsidian knowledge base: an agent compiles articles and notes into a linked wiki, answers from it and health-checks it
Agent Client for Obsidian
Agent Client
An Obsidian plugin that runs Claude Code, Codex and other agents via the Agent Client Protocol right inside your notes vault
A set of skills and agents for a second brain on markdown and git: notes, a knowledge base and a people CRM with no database or cloud
README in short
The README describes context loss between sessions and contrasts the approach with Karpathy's LLM Wiki: sources rewrite pages instead of only appending. It walks through command scenarios and a before and after table. Claude Code installs via the plugin marketplace or a script, other agents via per-platform builds. It ends with optional research API keys and their costs.