Skip to content

A self-organizing Obsidian vault that gives AI coding agents persistent memory.

docs: add upgrade guide, update quick start for multi-agent

Brenno Ferraric8cd76350e9a
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 91e33e8..ccf6ca7 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -69,7 +69,7 @@ jobs:
cat > /tmp/release_body.md <<'HEADER'
## Quick Start
- **Requirements:** [Obsidian](https://obsidian.md), [Claude Code](https://claude.ai/code), [Python 3.8+](https://python.org/downloads)
+ **Requirements:** [Obsidian](https://obsidian.md), [Python 3.8+](https://python.org/downloads), and an AI agent: [Claude Code](https://claude.ai/code), [Codex CLI](https://github.com/openai/codex), or [Gemini CLI](https://github.com/google-gemini/gemini-cli)
```bash
git clone https://github.com/breferrari/obsidian-mind.git
@@ -78,7 +78,7 @@ jobs:
qmd index && qmd embed # build search index
```
- Or download the vault zip below and extract it into your Obsidian vaults folder. Open it in Claude Code and run `/om-standup`.
+ Or download the vault zip below and extract it into your Obsidian vaults folder. Open it in your agent and run `om-standup`.
HEADER
# Strip leading whitespace from heredoc
diff --git a/README.ja.md b/README.ja.md
index 70cfee2..fac6a64 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -99,7 +99,7 @@ Decision: defer Redis migration. Win: Sarah praised the auth architecture.
1. このリポジトリをクローン(または**GitHubテンプレート**として使用)
2. フォルダを**Obsidianボールト**として開く
3. 設定 → 一般で**Obsidian CLI**を有効化(Obsidian 1.12以上が必要)
-4. ボールトディレクトリで**`claude`**を実行
+4. ボールトディレクトリでエージェントを実行:**`claude`**、**`codex`**、または**`gemini`**
5. **`brain/North Star.md`**に目標を記入 — これがすべてのセッションの基盤になります
6. 仕事について話し始める
@@ -386,14 +386,39 @@ YAMLフロントマター付きテンプレート。段階的開示のための`
## 🔄 アップグレード
+### 既存クローンの更新
+
+リポジトリを直接クローンした場合:
+
+```bash
+cd your-vault
+git pull origin main
+```
+
+新しいファイル(`AGENTS.md`、`GEMINI.md`、`.codex/`、`.gemini/`)が自動的に追加され、フックスクリプトも更新されます。
+
+### フォークの更新
+
+リポジトリをフォークした場合:
+
+```bash
+git remote add upstream https://github.com/breferrari/obsidian-mind.git
+git fetch upstream
+git merge upstream/main
+```
+
+カスタマイズしたファイル(通常は`CLAUDE.md`、`brain/`ノート)のコンフリクトを解消してください。インフラファイル(`.claude/scripts/`、`.codex/`、`.gemini/`)はクリーンにマージされます。
+
+### 古いボールトからの移行
+
obsidian-mindの古いバージョン(または任意のObsidianボールト)をお使いですか?`/om-vault-upgrade`コマンドでコンテンツを最新テンプレートに移行できます:
```bash
# 1. 最新のobsidian-mindをクローン
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault
-# 2. Claude Codeで開く
-cd ~/new-vault && claude
+# 2. エージェントで開く
+cd ~/new-vault && claude # または codex、gemini
# 3. 古いボールトを指定してアップグレードを実行
/om-vault-upgrade ~/my-old-vault
diff --git a/README.ko.md b/README.ko.md
index ee2ce6b..7688c00 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -99,7 +99,7 @@ You: "wrap up"
1. 이 저장소를 클론하거나 **GitHub 템플릿**으로 사용하세요
2. 폴더를 **Obsidian 볼트**로 엽니다
3. 설정 → 일반에서 **Obsidian CLI**를 활성화합니다 (Obsidian 1.12+ 필요)
-4. 볼트 디렉토리에서 **`claude`**를 실행합니다
+4. 볼트 디렉토리에서 에이전트를 실행합니다: **`claude`**, **`codex`**, 또는 **`gemini`**
5. **`brain/North Star.md`**에 목표를 작성합니다 — 이것이 모든 세션의 기준이 됩니다
6. 업무에 대해 이야기를 시작하세요
@@ -386,16 +386,41 @@ YAML 프론트매터가 포함된 템플릿으로, 각각 점진적 공개를
## 🔄 업그레이드
+### 기존 클론 업데이트
+
+리포지토리를 직접 클론한 경우:
+
+```bash
+cd your-vault
+git pull origin main
+```
+
+새 파일(`AGENTS.md`, `GEMINI.md`, `.codex/`, `.gemini/`)이 자동으로 추가되고 훅 스크립트도 업데이트됩니다.
+
+### 포크 업데이트
+
+리포지토리를 포크한 경우:
+
+```bash
+git remote add upstream https://github.com/breferrari/obsidian-mind.git
+git fetch upstream
+git merge upstream/main
+```
+
+커스터마이징한 파일(일반적으로 `CLAUDE.md`, `brain/` 노트)의 충돌을 해결하세요. 인프라 파일(`.claude/scripts/`, `.codex/`, `.gemini/`)은 깔끔하게 병합됩니다.
+
+### 이전 볼트에서 마이그레이션
+
이전 버전의 obsidian-mind(또는 기존 Obsidian 볼트)를 사용 중이신가요? `/om-vault-upgrade` 명령어가 최신 템플릿으로 콘텐츠를 마이그레이션합니다:
```bash
-# 1. Clone the latest obsidian-mind
+# 1. 최신 obsidian-mind 클론
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault
-# 2. Open it in Claude Code
-cd ~/new-vault && claude
+# 2. 에이전트로 열기
+cd ~/new-vault && claude # 또는 codex, gemini
-# 3. Run the upgrade pointing to your old vault
+# 3. 이전 볼트를 지정하여 업그레이드 실행
/om-vault-upgrade ~/my-old-vault
```
diff --git a/README.md b/README.md
index c8b611a..21e88e5 100644
--- a/README.md
+++ b/README.md
@@ -98,7 +98,7 @@ You: "wrap up"
1. Clone this repo (or use it as a **GitHub template**)
2. Open the folder as an **Obsidian vault**
3. Enable the **Obsidian CLI** in Settings → General (requires Obsidian 1.12+)
-4. Run **`claude`** in the vault directory
+4. Run your agent in the vault directory: **`claude`**, **`codex`**, or **`gemini`**
5. Fill in **`brain/North Star.md`** with your goals — this grounds every session
6. Start talking about work
@@ -385,21 +385,46 @@ This is a starting point. Adapt it to how you work:
## 🔄 Upgrading
-Already using an older version of obsidian-mind (or any Obsidian vault)? The `/om-vault-upgrade` command migrates your content into the latest template:
+### Updating an existing clone
+
+If you cloned the repo directly:
+
+```bash
+cd your-vault
+git pull origin main
+```
+
+That's it. New files (`AGENTS.md`, `GEMINI.md`, `.codex/`, `.gemini/`) appear automatically and hook scripts are updated in place.
+
+### Updating a fork
+
+If you forked the repo:
+
+```bash
+git remote add upstream https://github.com/breferrari/obsidian-mind.git
+git fetch upstream
+git merge upstream/main
+```
+
+Resolve any conflicts in files you customized (typically `CLAUDE.md`, `brain/` notes). Infrastructure files (`.claude/scripts/`, `.codex/`, `.gemini/`) should merge cleanly.
+
+### Migrating from an older vault
+
+Using an older version of obsidian-mind (or any Obsidian vault)? The `/om-vault-upgrade` command migrates your content into the latest template:
```bash
# 1. Clone the latest obsidian-mind
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault
-# 2. Open it in Claude Code
-cd ~/new-vault && claude
+# 2. Open it in your agent
+cd ~/new-vault && claude # or codex, or gemini
# 3. Run the upgrade pointing to your old vault
/om-vault-upgrade ~/my-old-vault
```
The agent will:
-1. **Detect** your vault version (v1–v3.2, or identify it as a non-obsidian-mind vault)
+1. **Detect** your vault version (v1–v3.x, or identify it as a non-obsidian-mind vault)
2. **Inventory** every file — classify as user content, scaffold, infrastructure, or uncategorized
3. **Present a migration plan** — you see exactly what will be copied, transformed, and skipped
4. **Execute** after your approval — transforms frontmatter, fixes wikilinks, rebuilds indexes
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 5cb80da..7735a96 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -99,7 +99,7 @@ Decision: defer Redis migration. Win: Sarah praised the auth architecture.
1. 克隆此仓库(或使用它作为 **GitHub 模板**)
2. 将文件夹作为 **Obsidian 仓库** 打开
3. 在 设置 → 通用 中启用 **Obsidian CLI**(需要 Obsidian 1.12+)
-4. 在仓库目录中运行 **`claude`**
+4. 在仓库目录中运行你的 Agent:**`claude`**、**`codex`** 或 **`gemini`**
5. 在 **`brain/North Star.md`** 中填写你的目标——这将为每次会话定下基调
6. 开始谈论工作
@@ -386,14 +386,39 @@ templates/ 带有 YAML frontmatter 的 Obsidian 模板
## 🔄 升级
+### 更新已有克隆
+
+如果你直接克隆了仓库:
+
+```bash
+cd your-vault
+git pull origin main
+```
+
+新文件(`AGENTS.md`、`GEMINI.md`、`.codex/`、`.gemini/`)会自动出现,钩子脚本也会就地更新。
+
+### 更新 Fork
+
+如果你 Fork 了仓库:
+
+```bash
+git remote add upstream https://github.com/breferrari/obsidian-mind.git
+git fetch upstream
+git merge upstream/main
+```
+
+解决你自定义过的文件的冲突(通常是 `CLAUDE.md`、`brain/` 笔记)。基础设施文件(`.claude/scripts/`、`.codex/`、`.gemini/`)应该可以干净合并。
+
+### 从旧仓库迁移
+
已经在使用旧版本的 obsidian-mind(或其他 Obsidian 仓库)?`/om-vault-upgrade` 命令可以将你的内容迁移到最新模板:
```bash
# 1. 克隆最新版 obsidian-mind
git clone https://github.com/breferrari/obsidian-mind.git ~/new-vault
-# 2. 在 Claude Code 中打开
-cd ~/new-vault && claude
+# 2. 用你的 Agent 打开
+cd ~/new-vault && claude # 或 codex、gemini
# 3. 运行升级命令,指向你的旧仓库
/om-vault-upgrade ~/my-old-vault