# breferrari/obsidian-mind

A self-organizing Obsidian vault that gives AI coding agents persistent memory. Claude Code, Codex CLI, Gemini CLI.

Repository: https://github.com/breferrari/obsidian-mind
Canonical: https://ross.abutalabs.com/products/obsidian-mind
Language: TypeScript
License: MIT
License Family: permissive
Topics: ai-agents, claude-code, codex-cli, gemini-cli, knowledge-management, obsidian, obsidian-vault, persistent-memory, second-brain, template
Last push: 2026-08-24T10:57:37+00:00

## Health v2 (maintenance only)
Score: 82/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 13
- inputs: {"age_days": 186, "days_push": 9, "days_rel": 10, "gap_med": 1, "n_releases_24m": 26}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4562, forks 525 (observed 2026-08-28T04:08:53.473228+00:00)

## What it is
Obsidian Mind is a self-organizing Obsidian vault template that gives AI coding agents like Claude Code, Codex CLI, and Gemini CLI persistent memory across sessions. It ships with hooks, slash commands, and automated note-taking so every conversation builds on prior context, decisions, and project state.

## Use cases
- give my AI coding agent persistent memory between sessions
- stop re-explaining project context to Claude Code every session
- run a morning standup briefing from my notes and git history
- brain dump meeting notes and have them organized automatically
- track decisions and tasks across AI agent conversations
- set up a second brain vault that AI agents can read and write
- integrate Obsidian with Codex CLI or Gemini CLI via hooks

## When to choose
- you use Claude Code, Codex CLI, or Gemini CLI daily and lose context between sessions
- you already use or want to adopt Obsidian as a knowledge base
- you want an opinionated, ready-made vault with hooks and commands rather than building your own
- you want your agent to maintain indexes, links, and project state automatically

## When to avoid
- you don't use Obsidian and don't want a Markdown-vault-based memory system
- you need a programmatic memory API or vector database rather than a file-based vault
- you only use AI agents in IDEs or chat UIs without CLI hook support
- you need a lightweight solution without adopting an entire vault structure

## Facets
- artifact type: application
- maturity: active
- function: agent-framework, prompt-engineering, developer-tools, workflow-automation, search-engine, documentation, markdown
- domain: developer-tools
- platform: cross-platform, cli
- tags: obsidian, obsidian-vault, persistent-memory, second-brain, claude-code, codex-cli, gemini-cli, template, knowledge-management, ai-memory, ai-agents, automation, nodejs

## Member repositories
- breferrari/obsidian-mind (main) score 82

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:53.473228+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:19:59.778725+00:00, confidence not recorded.
  - readme: https://github.com/breferrari/obsidian-mind (fetched 2026-08-28T04:08:53.473228+00:00, sha aca144529d63)
- Data as of 2026-08-30T08:39:29.467469+00:00.