Repolode
Submit
eugeniughelbur

eugeniughelbur/obsidian-second-brain

Persistent memory for Claude Code, Codex and other AI agents, stored as plain markdown in an Obsidian vault.

View on GitHubWebsite
Stars
5,192
Forks
641
Open issues
12
Last commit
3 days ago

What is it?

obsidian-second-brain gives AI coding agents such as Claude Code, Codex, Gemini CLI and OpenCode a long-term memory stored as plain markdown files in an Obsidian vault. Instead of re-explaining a project every session, the agent saves decisions, tasks, people and ideas into the right notes, and later searches them with semantic retrieval.

The project provides about 49 slash commands grouped into operations (saving, ingesting URLs, PDFs, Word files, audio and images, reconciling contradictions, daily notes, boards), thinking tools (challenge, brainstorm, pattern detection) and research tools that pull in X posts, web sources with citations, and YouTube or podcast transcripts. It also includes scheduled agents for a morning brief, nightly consolidation, weekly review and vault health checks.

A newer component, Crew, keeps a shared job log across Claude Code, Codex, Cursor and Grok Bot in any plain folder, and works without Obsidian. Presets for executive, builder, creator and researcher roles set up tailored vault layouts.

Key features

  • 01Saves decisions, tasks, people and ideas from a conversation into the right vault notes.
  • 02Ingests URLs, PDFs, Word and OpenDocument text files, audio and images into existing pages.
  • 03Semantic search and a retrieval evaluation command for measuring vault search quality.
  • 04Research commands with citations, including free key-less sources when no API keys are set.
  • 05Scheduled agents for morning briefs, nightly consolidation, weekly reviews and health audits.
  • 06Crew shares a job log across several agents in any plain folder.

Use cases

  • Keeping context across daily sessions with Claude Code or Codex without re-explaining a project.
  • Turning meeting recordings, documents and web articles into cross-linked Obsidian notes.
  • Running vault-grounded research that checks new web sources against what you already know.
  • Letting several coding agents share a log of completed work and lessons.

Quick start

  1. 1

    Run the official quick-install script from the README

  2. 2

    Restart Claude Code, then type the Crew setup command

    /crew setup

Things to know

  • The quick install script is fetched with curl and piped into bash, so review it first if you prefer.
  • Crew needs Python 3.10 or later.
  • Word and OpenDocument ingestion needs LibreOffice 26.2+ installed separately.

In collections

Long-term memory for AI agentsClaude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI agent skill librariesStatic site generators & documentation tools

Topics

#agent-memory#obsidian#claude-code#ai-agents#knowledge-management#personal-knowledge-management#markdown#agent-skills#ai-note-taking#ai-second-brain

FAQ

What is obsidian-second-brain?
Persistent memory for Claude Code, Codex and other AI agents, stored as plain markdown in an Obsidian vault. obsidian-second-brain gives AI coding agents such as Claude Code, Codex, Gemini CLI and OpenCode a long-term memory stored as plain markdown files in an Obsidian vault. Instead of re-explaining a project every session, the agent saves decisions, tasks, people and ideas into the right notes, and later searches them with semantic retrieval.
Is obsidian-second-brain free to use? What license does it have?
obsidian-second-brain is open source under the MIT license. Check the license terms before using it in commercial products.
Is obsidian-second-brain still maintained?
Actively maintained. The last commit to obsidian-second-brain was on Nov 4, 2026.
What can I use obsidian-second-brain for?
Keeping context across daily sessions with Claude Code or Codex without re-explaining a project. Turning meeting recordings, documents and web articles into cross-linked Obsidian notes. Running vault-grounded research that checks new web sources against what you already know. Letting several coding agents share a log of completed work and lessons.
How do I install obsidian-second-brain?
Run the official quick-install script from the README Restart Claude Code, then type the Crew setup command: /crew setup
Where can I get obsidian-second-brain?
The source code and installation instructions are on GitHub: https://github.com/eugeniughelbur/obsidian-second-brain

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects