Homebrew Claude Code Hooks

claude-code-hooks

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

• claude-code-hooks save — Claude Code のフックから呼び出され、イベントをノートに追記する
• claude-code-hooks open — セッションのノートを Obsidian で開く（引数なしで現在のセッション）
• claude-code-hooks backfill — 既存ノートに session リンクをバックフィルする
• claude-code-hooks setup — フック設定を ~/.claude/settings.json に適用する
• claude-code-hooks notify — macOS 通知を表示するヘルパー（クリックでペインを前面化。フォーカス検出対応。kitty / WezTerm）
• claude-code-hooks tabcolor — Claude Code の状態に応じてタブ色を変える（kitty / WezTerm 対応）
• claude-code-hooks gh-guard — gh が保護対象ホストに書き込む前に確認プロンプトを強制する
• 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`）を作成し、時系列でイベントを追記していく。

対応イベントと記録内容

フックイベント	記録内容
UserPromptSubmit	ユーザーの入力テキスト（## User 見出し）
Stop	アシスタントの応答（## Assistant 見出し）
PostToolUse	ツール使用（下記参照）
SessionEnd	Haiku で要約を生成しフロントマターの後に挿入。終了時刻を記録（下記）

PostToolUse で記録するツール

ツール名	記録形式	備考
Bash	`> [!terminal]- descr