Obsidian Second Brain

by Eugeniu GhelburPluginGet organised

Lets Claude Code save, find and update notes in your Obsidian vault across sessions

View on GitHub

The problem it solves

You open a new Claude session and spend ten minutes re-explaining a project you already made decisions on last week.

For Obsidian usersFounders and operatorsWriters and researchers

Before: You copy decisions into notes by hand, or explain the same background again at the start of every session.
After: One command files decisions, people and tasks into linked notes in your vault, and a later session can search them and pick up where you left off.

Stars: ★ 5.1k
License: MIT
Cost: Free
For: Claude Code
Contents: Includes scripts

Screenshots

From the project's own repository · 3 images, swipe or use the arrows.

A terminal demo: one save command turns a conversation into linked person, project and daily notes — Image: Eugeniu Ghelbur (MIT). Original file

Adding the plugin from its Claude Code marketplace and seeing it listed as enabled — Image: Eugeniu Ghelbur (MIT). Original file

Overview

Obsidian Second Brain is a Claude Code plugin that uses your Obsidian vault as long-term memory. After a conversation, one command files the decisions, people and tasks into linked notes, and a later session can search the vault and load that context. It can also turn links, PDFs, voice memos and screenshots into notes and update the pages they touch. It suits people who already keep notes in Obsidian and use Claude Code every day.

Your notes stay as plain Markdown files in your own vault, so the memory outlasts any one AI tool.

Try these first

Start with the first one: it is a small task you can check easily.

Run /obsidian-second-brain:obsidian-init in a new test vault, then save this conversation with /obsidian-second-brain:obsidian-save.First try · writes to your vault
/obsidian-second-brain:obsidian-find What did we decide about [project name]?read-only
/obsidian-second-brain:obsidian-ingest [link to an article or video]writes to your vault
/obsidian-second-brain:obsidian-challenge I'm about to decide [decision]. What does my vault say about this?

Example prompts written by Agent Flows Hub.

What you get

From the creator's documentation.

Output	What it is	Reads
Save a conversation	Files decisions, people, tasks and ideas from the chat into linked notes	Your vault
Search your notes	Finds past notes and loads them as context in a new session	Your vault
Ingest sources	Turns links, PDFs, voice memos and screenshots into notes and updates related pages	Your vault
Daily notes	Builds today's note with overdue tasks and overnight changes	Your vault
Research commands	Pull web, X and YouTube material into notes; the X and YouTube ones need your own API keys	Web and paid APIs
Scheduled agents	Morning, nightly, weekly and health runs that stay off until you turn them on	Your vault

Good to know

Keep what you decide in Claude Code sessions in your own Obsidian vault. The plugin files a conversation into linked notes and lets a later session search them, so you explain less each time.

Limits

Plugin commands carry a prefix, for example /obsidian-second-brain:obsidian-save, and the vault path must be set in Claude Code's settings before the first run.
The X, YouTube and podcast research commands need their own API keys (xAI, Gemini or others), and most are charged per call by those services. The background and scheduled agents stay off until you turn them on.

Notes by Agent Flows Hub (original project name: obsidian-second-brain), written from the creator's documentation, not from running it ourselves. obsidian-second-brain README: install and commands · obsidian-second-brain changelog

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Install Claude Code firstThe plugin adds to Claude Code; it does not work on its own.
Type the commands into Claude CodePaste the install request into Claude Code, or enter these lines yourself one by one or follow the official guide./plugin marketplace add eugeniughelbur/obsidian-second-brain /plugin install obsidian-second-brain@obsidian-second-brain
Give it a first taskRun the init command in a new test vault, save one short conversation, and open the notes it created in Obsidian before using it on your real vault.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

Claude Code, installed.
An Obsidian vault folder, plus one line in Claude Code's settings that points to it
uv, the Python tool the plugin's helpers and vault server run on
Optional xAI, Gemini or Perplexity API keys for the research commands
It runs scripts and connects to the internet. Read the official page to see what it does before installing.
Free. Nothing to pay.

Details

Made by: Eugeniu Ghelbur
License: MIT Terms
For: Claude Code
Runs on: Your computer

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/obsidian-second-brain/install.md

Other plugins

OpenCode Notifier Plays a sound and shows a desktop alert when OpenCode finishes, fails or needs your OK
Receipts for Claude Code Makes a printable report of what your Claude Code use shipped, by project, for a manager
Save to Spotify Turns notes, articles or meeting transcripts into narrated episodes saved to your Spotify
Telegram for Claude Code Lets you message your running Claude Code session from Telegram and get replies there
text-to-cad Lets your AI agent design 3D parts from a description and export files ready to print
UI Design Skills Helps you choose color palettes, type scales, grids and layouts for app or web screens

See all 30 plugins

GitHub