https://github.com/shimosan/claude-code-save-chat
Archive Claude Code conversations to Obsidian via /save-chat, with cloud-shared multi-device config
https://github.com/shimosan/claude-code-save-chat
anthropic chat-history claude-code knowledge-management markdown multi-device obsidian pkm save-chat slash-commands
Last synced: 19 days ago
JSON representation
Archive Claude Code conversations to Obsidian via /save-chat, with cloud-shared multi-device config
- Host: GitHub
- URL: https://github.com/shimosan/claude-code-save-chat
- Owner: shimosan
- License: other
- Created: 2026-05-22T12:51:50.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-29T11:40:12.000Z (24 days ago)
- Last Synced: 2026-05-29T13:17:04.884Z (24 days ago)
- Topics: anthropic, chat-history, claude-code, knowledge-management, markdown, multi-device, obsidian, pkm, save-chat, slash-commands
- Homepage:
- Size: 25.4 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# claude-code-save-chat
複数端末で利用する Claude Code (CLI / VS Code 拡張 / Cursor 等) の chat 履歴サマリーを Obsidian vault のノートに保存するためのコマンド `/save-chat` を実装する。あわせて、Claude Code の設定ファイルをクラウドストレージ (Dropbox / iCloud Drive / Google Drive 等) 経由で複数端末間で共有する。Obsidian vault もクラウドストレージ経由で共有すると便利。
## 配置場所
このフォルダはクラウド同期される場所であればどこに置いてもよい。
例:
- `~/Dropbox/library/claude/`
- `~/iCloud/claude-library/`
- `~/GoogleDrive/claude/`
## 構成
```
/
├── README.md ← このファイル
├── .claude/CLAUDE.md ← library repo の保守ルール (この repo 編集用、配布しない)
├── dotclaude/ ← 各端末の ~/.claude/ へ deploy する同期マスター
│ ├── CLAUDE.md ← クラウド共有のルール集
│ └── CLAUDE.local.md ← 端末固有設定のひな型
├── .gitignore ← git 除外パターン
├── commands/ ← slash commands
│ └── save-chat.md ← 会話を Obsidian vault に保存
├── codex/ ← Codex 版 skill の配布用原本 (任意・Codex 利用端末のみ)
│ └── skills/save-chat/SKILL.md ← Codex 版 save-chat (参照型)
├── copilot/ ← Copilot 版 prompt の配布用原本 (任意・VS Code + Copilot 端末のみ)
│ └── prompts/save-chat.prompt.md ← Copilot 版 save-chat (参照型)
├── scripts/ ← 補助スクリプト集 (任意。README は目次、必要に応じて個別 md)
│ ├── README.md ← scripts の目次
│ ├── patch-vscode-webview-ctrlf.md ← Ctrl-F 修正 patcher の詳細
│ └── patch-vscode-webview-ctrlf.js ← VS Code/Cursor webview 入力欄の Ctrl-F 修正 patcher
├── scratch/ ← ローカル退避用 (.gitignore 対象、load/save 対象外)
├── local/ ← 利用者ローカル領域 (.gitignore 対象)
└── notes/ ← 開発メモ (.gitignore 対象)
```
## 新端末のセットアップ
Claude Code に依頼する:
> 「`/dotclaude/CLAUDE.md` を読んでセットアップして」
`dotclaude/CLAUDE.md` 内のセットアップ手順に沿って Claude が `~/.claude/` 配下を整える。
> **既存端末の更新時**: `CLAUDE.local.md` は自由領域 (端末ローカル管理)。template の構造が変わっても、新 template に合わせる (例: 端末情報をホスト名のみにする) か、旧記述をそのまま引き継ぐかは **ユーザーが決める**。Claude は自動で上書きせず、どちらにするか確認する。
## `/save-chat` — 会話を Obsidian vault に保存
現在の会話を markdown ノートとして Obsidian vault に書き出す slash command。
- **保存先**: vault 内の **AI ノートフォルダ** (`claude{YYYY}/` 等)
- **構造**: frontmatter (tags / model / machine / session_id 等) + 本体 + 改訂履歴
- **改訂モード**: 同 slug 既存ファイルがあれば上書き + 改訂履歴に追記
- **テンプレート**: default / qa / worklog / troubleshoot / decision から会話の性質に応じて選択
```
/save-chat ← slug 自動生成
/save-chat my-topic-slug ← slug 指定
```
詳細仕様は [`commands/save-chat.md`](commands/save-chat.md) を参照。
## Codex 版 save-chat (任意)
Codex でも save-chat を使える。Codex 版は**参照型** — 実行時に Claude Code 版の原典 (`~/.claude/commands/save-chat.md`) を仕様として読むので、原典の更新に自動追従する (フォークではない)。
> **前提: `~/.claude/CLAUDE.local.md` が必須。** spec (`commands/save-chat.md`) と `CLAUDE.md` は `~/.claude/` に無ければ library 側 (それぞれ `/commands/`、`/dotclaude/`) へフォールバックする。ただし `CLAUDE.local.md` は端末ローカル専用で library に複製が無く (`vault_path` と `library_path` を保持)、これが無いと保存先も library の位置も解決できない。
- **呼び出し**: slash command ではなく skill の自然文トリガー。例: `save-chatしてください` / `/save-chat` / `save-chat `
- **frontmatter**: `source: codex` (`model` / `session_id` は安定取得できる場合のみ記録)
- **sandbox**: vault が Codex の writable root 外なら保存時に承認を求める (vault 全体を writable root にはしない。必要なら `claude{YYYY}` だけ許可する程度に留める)
### 展開 (Codex)
- 原本 (正): `/codex/skills/save-chat/SKILL.md`
- 展開先: `~/.codex/skills/save-chat/SKILL.md`
```bash
mkdir -p ~/.codex/skills/save-chat
cp -v /codex/skills/save-chat/SKILL.md ~/.codex/skills/save-chat/SKILL.md
```
新端末セットアップ時に Claude Code 版の load と一緒に展開してもよいし、Codex 自身にこの README を読ませて展開させてもよい。Codex を使わない端末では不要。
- これは Claude Code 設定の load/save (双方向同期) とは**独立した一方向配布** (原本 → 端末)。
- 編集の正は **library 側の原本**。skill を直すときは原本を編集して各端末へ再配布する (端末側を直接いじったら原本にも反映する)。
- 同期対象は `codex/skills/*/SKILL.md` のみ。`~/.codex/` 配下のその他 (auth・sessions 等の端末ローカル状態) は同期しない。
## Copilot 版 save-chat (任意)
VS Code + GitHub Copilot でも save-chat を使える。Copilot 版は**参照型** — 実行時に Claude Code 版の原典 (`~/.claude/commands/save-chat.md`) を仕様として読む (フォークではない)。
> **前提: `~/.claude/CLAUDE.local.md` が必須。** spec (`commands/save-chat.md`) と `CLAUDE.md` は `~/.claude/` に無ければ library 側 (それぞれ `/commands/`、`/dotclaude/`) へフォールバックする (Codex 版と同等)。ただし `CLAUDE.local.md` は端末ローカル専用で library に複製が無く (`vault_path` と `library_path` を保持)、これが無いと保存先も library の位置も解決できない。
- **呼び出し**: Copilot Chat の `/save-chat` (`/save-chat ` で slug 指定)
- **frontmatter**: `source: github-copilot`
### 展開 (Copilot)
VS Code の **user prompts** ディレクトリ (エディタ共通。Copilot Chat が `/` で拾う) に prompt 1 ファイルを置く。
- 原本 (正): `/copilot/prompts/save-chat.prompt.md`
- 展開先:
- macOS: `~/Library/Application Support/Code/User/prompts/save-chat.prompt.md`
- Windows: `%APPDATA%\Code\User\prompts\save-chat.prompt.md`
- Linux: `~/.config/Code/User/prompts/save-chat.prompt.md`
```bash
# macOS の例
mkdir -p ~/"Library/Application Support/Code/User/prompts"
cp -v /copilot/prompts/save-chat.prompt.md ~/"Library/Application Support/Code/User/prompts/save-chat.prompt.md"
```
- prompts ディレクトリは VS Code が自動生成しないので、無ければ作ってからコピーする (Windows は親があっても `prompts` 自体が無いことがある)。
- コピー後は VS Code を再読込/再起動し、Copilot Chat で `/save-chat` が見えることを確認する。
- VS Code Insiders を使う端末は `Code - Insiders` 配下 (`~/Library/Application Support/Code - Insiders/User/prompts/` 等) に合わせる。
- 編集の正は **library 側の原本**。load/save (双方向同期) とは独立した一方向配布 (原本 → 端末)。同期対象は `copilot/prompts/*.prompt.md` のみ。
## Obsidian vault 管理
Claude Code は vault 内のフォルダを 3 系統に分類して扱う:
- **AI ノートフォルダ** (`claude{YYYY}/` 等) — save-chat の保存先、Read/Write 自由
- **閲覧可能ノートフォルダ** — 過去アーカイブやユーザーが開放したノート、Read 自由・書き込み不可
- **閲覧禁止ノートフォルダ** — 個人ノート、ファイル名のみ閲覧可、本文は条件付きアクセス
各端末の vault パスとフォルダ命名は `CLAUDE.local.md` で定義。アクセスルールは [`dotclaude/CLAUDE.md`](dotclaude/CLAUDE.md) を参照。
## 運用
ローカル (`~/.claude/`) と本 library の間で `load` / `save` で同期する。
詳細は [`dotclaude/CLAUDE.md`](dotclaude/CLAUDE.md) を参照。
## 補助スクリプト — `scripts/`
`scripts/` は `/save-chat` 本体とは独立した補助ツール置き場。Claude Code / Codex / VS Code / Cursor 周辺で見つかった再利用可能な修正・診断スクリプトをここに置く。[`scripts/README.md`](scripts/README.md) は目次とし、軽いスクリプトは 1-2 行の説明だけでよい。使い方・注意点・復旧手順が必要なものは、スクリプト専用の `.md` に詳しく書く。
現在の主なスクリプト:
- [`patch-vscode-webview-ctrlf.js`](scripts/patch-vscode-webview-ctrlf.js): Claude Code / Codex の VS Code/Cursor webview 入力欄で macOS `Control-F` が forward-character として動かない問題を、ローカル拡張 webview への小さな patch で補正する。`--status` / `--dry-run` / `--restore` 対応。詳細は [`scripts/patch-vscode-webview-ctrlf.md`](scripts/patch-vscode-webview-ctrlf.md)。
`scripts/` の内容は任意利用。新端末セットアップに必須ではなく、必要な端末で必要なものだけ実行する。
## ローカル領域 — `local/` · `notes/`
`.gitignore` 対象のフォルダで、**git 管理外＝バージョン管理されない利用者ローカル領域**。commit も push もされず、`git pull` でライブラリを更新しても**上書きされない**。各自のローカルな内容を安心して置ける (remote が public でも露出しない)。
- `local/` : 端末固有・個人的な設定や事実 (例: マシン台帳)。git に入れたくないがすぐ参照したいもの。
- `notes/` : 長期保存の開発メモ・気付き (日付付き md, `YYYY-MM-DD_topic.md` 推奨)。
> **クラウド同期との合わせ技**: 本 library 全体をクラウド同期フォルダ (Dropbox 等) に置いている場合、これらの gitignore 対象フォルダも git / GitHub を経由せず端末間で自動同期される。マシン台帳を全端末で共有する、といった用途に使える。
### `local/machines.md` のフォーマット例
複数端末を使うなら端末一覧をここに置くと便利 (gitignore 対象なので各自が空から作る)。**フォーマットは好みでよい**。例えば 1 端末 1 行、5 フィールド:
```
`` (<機種>, <プロセッサ>, <コア数>, <メモリ>, )
```
- **hostname**: ユーザーが選ぶ呼称ラベル。OS のホスト名 (`foo.local` の `.local` 等) そのままでなくてよい。`CLAUDE.local.md` のホスト名も同じ
- **プロセッサ**: Apple Silicon は CPU+GPU 一体なので 1 トークン (`M4 Max`)。ディスクリート GPU 機は `CPU / GPU` (`Ryzen 9 7950X / RTX 4090`)
- **OS**: `mac` / `win` / `linux` (Mac/Windows/Linux の判別用、末尾固定)
例:
- `host-a` (MacBook Pro, M4 Max, 16-core, 64GB, mac)
- `host-b` (Mac Studio, M1 Ultra, 20-core, 128GB, mac)
- `host-c` (Surface Laptop, Core Ultra 7, 16-core, 32GB, win)
- `host-d` (自作, Ryzen 9 7950X / RTX 4090, 16-core, 128GB, linux)
1 行でも例が入っていれば、以降の端末追加は Claude が同じ形式で書く。
## OS 固有の注意
load/save やパス操作は POSIX (macOS / Linux) 前提。Mac・Linux は基本そのまま動き、差異が出るのは主に Windows。OS 固有の対処はここに集約する。
### Windows
- **load/save は Bash ツールで実行**: `cp -v` / `diff` を PowerShell でなく Bash ツールで実行すれば Mac と同じコマンドが使える (PowerShell の `diff` は `Compare-Object` のエイリアスで出力が別物)。
- **パスは POSIX 変換**: `D:\Dropbox\library\claude` → `/d/Dropbox/library/claude` に変換して Bash に渡す。`CLAUDE.local.md` のパス定義は Windows 表記 (`D:\...`) のまま書き、使用時に変換する。
- **端末固有メモは FREEZONE へ**: POSIX パス変換・`hostname` の挙動・projects パスエンコード等の Windows 専用補足は `CLAUDE.local.md` の FREEZONE 以下に置く (構造化セクションは template 準拠のまま保つ)。
- **GPU スペック取得**: `Get-WmiObject Win32_VideoController` 等で取得。machines.md の `プロセッサ` 欄にはディスクリート GPU を採用 (統合 GPU は除外)。
## 注意
- 本 library に**個人 secrets を置かない** (`.env`, API キー等は別の場所へ)
- `CLAUDE.local.md` は端末ローカル管理 — クラウド共有しない
## License
MIT — see [LICENSE](LICENSE).