claude-code-hooks

Claude Code での会話やツール操作を Obsidian ノートに自動記録するための Go バイナリ。5つのサブコマンドで構成される。

• claude-code-hooks save — Claude Code のフックから呼び出され、イベントをノートに追記する
• claude-code-hooks backfill — 既存ノートに session リンクをバックフィルする
• claude-code-hooks setup — フック設定を ~/.claude/settings.json に適用する
• claude-code-hooks notify — macOS 通知を表示するヘルパー（WezTerm のフォーカス検出対応）
• claude-code-hooks tabcolor — Claude Code の状態に応じて WezTerm のタブ色を変える
• claude-code-hooks completion — シェル補完スクリプトを出力する（Bash / Zsh / Fish 対応）

インストール

brew tap delphinus/claude-code-hooks
brew install claude-code-hooks
claude-code-hooks setup

開発版（HEAD）をインストールする場合:

brew install --HEAD claude-code-hooks

使い方

claude-code-hooks setup

hooks.json の内容を ~/.claude/settings.json の hooks キーにマージする。env や model など端末固有の設定はそのまま保持される。

# 差分を確認（適用しない）
claude-code-hooks setup --diff

# hooks を適用
claude-code-hooks setup

claude-code-hooks save

Claude Code の各フックイベントに応じて、セッションごとに1つの Obsidian ノート（.md）を作成し、時系列でイベントを追記していく。

対応イベントと記録内容

PostToolUse で記録するツール

Bash コマンドのフィルタリング

ブロックリスト方式。以下のコマンドは探索用としてスキップする:

ls, cat, head, tail, wc, file, stat, which, where, type, echo, printf, pwd, cd, test, true, false, grep, rg, find, diff, sort, uniq, tr, cut, mkdir, rmdir, rm, cp, mv, ln, chmod, chown, touch, basename, dirname, realpath, readlink, tree, du, df, less, more, xargs, tee, whoami, hostname, date, uname, env, set, export, alias, id, jq

パイプやチェインで繋がったコマンドは、1つでも記録対象があれば全体を記録する。

再開セッションのリンク

claude -r でセッションを再開した場合、同じ session_id の既存ノートを自動検出し、新しいノートにリンクを追加する。

• frontmatter に related フィールドとして [[ファイル名]] のリストを追加
• 本文 に > [!link] Previous Sessions コールアウトとして wiki-link を追加

ノートのファイル名規則

YYYYMMDD-HHMMSS-SSID-タイトル.md

• SSID: セッション ID の先頭4文字
• タイトル: 最初のユーザープロンプトの先頭50文字から生成

claude-code-hooks backfill

既存の Obsidian ノートに対して、同じ session_id を持つノート間の related リンクをバックフィルする。何度実行しても安全（冪等）。

# 変更内容のプレビュー（ファイルは変更しない）
claude-code-hooks backfill --dry-run

# 実行
claude-code-hooks backfill

claude-code-hooks notify

macOS の通知を表示する。WezTerm 使用時は、現在のペインがフォーカスされている場合は通知を抑制する。

claude-code-hooks notify 'タイトル' 'メッセージ'

claude-code-hooks tabcolor

Claude Code の状態を WezTerm のタブ色で可視化する。各フックイベントで現在のペイン ($WEZTERM_PANE) の user var claude_state をセットし、WezTerm 側の format-tab-title でその値に応じてタブ背景を塗り分ける。

claude-code-hooks tabcolor <startup|thinking|idle|waiting|default>

• WezTerm 外（WEZTERM_PANE 未設定）では何もしない。
• 装飾目的なので wezterm cli の失敗は握り潰し、フックの流れを止めない。

状態と対応イベント

WezTerm 側の設定

wezterm.lua（または format-tab-title を定義しているファイル）で user var を読んでタブを塗る。use_fancy_tab_bar = true でもタブ背景に反映される。

local STATE_BG = {
  startup = "#7dcfff",
  thinking = "#bb9af7",
  idle = "#9ece6a",
  waiting = "#e0af68",
}

wezterm.on("format-tab-title", function(tab, tabs, panes, config, hover, max_width)
  local bg = STATE_BG[tab.active_pane.user_vars.claude_state or ""]
  local title = " " .. (tab.active_pane.title or "") .. " "
  if bg then
    return {
      { Background = { Color = bg } },
      { Foreground = { Color = "#1a1b26" } },
      { Text = title },
    }
  end
  return title
end)

claude-code-hooks completion

シェル補完スクリプトを出力する。Bash、Zsh、Fish に対応。

Homebrew でインストールした場合は補完が自動的にインストールされるため、手動設定は不要。

手動で設定する場合:

# Bash（~/.bashrc に追記）
eval "$(claude-code-hooks completion bash)"

# Zsh（~/.zshrc に追記）
eval "$(claude-code-hooks completion zsh)"

# Fish（~/.config/fish/config.fish に追記）
claude-code-hooks completion fish | source

環境変数

前提条件

• macOS + iCloud 同期の Obsidian vault（~/Library/Mobile Documents/iCloud~md~obsidian/Documents/Notes/Claude Code/）
• claude CLI（SessionEnd での要約生成に使用）

リリース

バージョンは Semantic Versioning に従う。新しいバージョンをリリースするには:

git tag v2.x.x
git push origin v2.x.x

タグをプッシュすると GitHub Actions が自動的に以下を実行する:

1. GitHub Release を作成（リリースノートは自動生成）
2. リリースの tarball から sha256 を計算
3. Formula/claude-code-hooks.rb を新しいバージョンの URL と sha256 で更新
4. Formula の変更を main ブランチにコミット・プッシュ

リリース後は brew upgrade claude-code-hooks で更新できる。

ファイル構成

~/.claude/
└── settings.json           # Claude Code の設定（端末固有、git 管理外）

~/.cache/claude-obsidian/
└── <session-id>            # セッションとノートの対応キャッシュ