oh-my-obsidian

◯ ─────────── ◯



O H - M Y - O B S I D I A N

◯ ─────────── ◯

Stop forgetting. Start remembering.
_{Give your AI coding agents a permanent, evolving second brain.}

English | 한국어

Quick Start · Why · How It Works · Commands · The Agents

Oh-my-obsidian transforms Claude Code into an agent with infinite memory.

AI coding agents are brilliant but amnesiac. Oh-my-obsidian bridges this gap by integrating an Obsidian vault directly into your Claude Code workflow. Through Socratic interviews, automated refactoring, and real-time Git sync, your AI learns your project's context, records its decisions, and recalls them perfectly across sessions.

---

Why Oh-My-Obsidian?

Most AI coding agents start every session with a blank slate.

Problem	What Happens	Oh-My-Obsidian Fix
Amnesia	AI forgets why a decision was made last week	session-save records architectural decisions into Markdown
Lost Context	You paste the same context over and over	recall automatically searches the vault for relevant past work
Messy Docs	Documentation rots and becomes disorganized	refactor safely reorganizes the vault as the project evolves
Setup Friction	Hard to bootstrap a good folder structure	Socratic setup interviews you to generate a tailored vault

---

Quick Start

Claude Code Quick Start

# 1. Add our custom marketplace
/plugin marketplace add https://github.com/hongdangmoo49/oh-my-obsidian

# 2. Install the plugin
/plugin install oh-my-obsidian@omob

Install via Official Marketplace — (Pending Approval) If installed from the official Claude registry:

/plugin install oh-my-obsidian

(For local development: claude --plugin-dir /path/to/oh-my-obsidian)

Initialize — Run the interactive Socratic setup wizard:

> /oh-my-obsidian:setup

Codex Quick Start

Codex reads the repository marketplace from:

.agents/plugins/marketplace.json

Add the marketplace from GitHub:

codex plugin marketplace add hongdangmoo49/oh-my-obsidian

Then open Codex and install oh-my-obsidian from the plugin directory:

/plugins

Then ask Codex:

Set up an Obsidian vault for this project.

After setup, you can continue with Codex using natural-language prompts or an explicit skill name such as:

What did we decide last time about the vault layout?
Save this session to the Obsidian vault.
Show me the vault health check.
Add a note to the vault for today's API decisions.
$oh-my-obsidian-recall Find our prior vault-layout decision.

What happens during setup?

The plugin will:

1. Check for the Obsidian desktop app on your system.
2. Conduct a Socratic interview to understand your project (domain, tech stack, team size).
3. Generate a tailored folder structure via the vault-architect agent.
4. Offer an optional Obsidian Git choice (safe, manual, or team-sync) after separate approvals.
5. For Codex, offer approval-gated official hooks and optional session history restore after validation.

Codex Plugin

Codex support is shipped from a separate plugin root:

plugins/oh-my-obsidian/

Use the Codex-native marketplace file:

.agents/plugins/marketplace.json

When users add hongdangmoo49/oh-my-obsidian as a Codex marketplace source, Codex reads this marketplace and exposes the bundled oh-my-obsidian plugin. Do not reuse .claude-plugin/marketplace.json for Codex.

Typical Codex start flow:

1. run codex plugin marketplace add hongdangmoo49/oh-my-obsidian
2. run codex, then open /plugins and install oh-my-obsidian
3. ask Codex: Set up an Obsidian vault for this project.

The Codex plugin keeps the same product shape: guided setup, recall, session-save, vault management, and official Codex hooks for project-local memory context. In Codex, these flows are typically used through natural-language prompts or explicit skill invocation rather than Claude-style slash commands.

Feature Matrix