Skillget

homebrew-claude-code-hooks

skill
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Gecti
  • Code scan — Scanned 6 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Claude Code hooks for Obsidian integration and notifications

README.md

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）を作成し、時系列でイベントを追記していく。

対応イベントと記録内容

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

PostToolUse で記録するツール

ツール名 記録形式 備考
Bash > [!terminal]- description (HH:MM:SS) + コード ブロックリストに該当するコマンドはスキップ
EnterPlanMode > [!plan] Entering Plan Mode (HH:MM:SS) related リンクの追加も試みる
ExitPlanMode > [!plan]- タイトル (HH:MM:SS) + プラン全文 プランの先頭行をタイトルに使用
Edit > [!file] Edit: path (HH:MM:SS) ファイルパスのみ（内容は記録しない）
Write > [!file] Write: path (HH:MM:SS) 同上

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 の失敗は握り潰し、フックの流れを止めない。

状態と対応イベント

状態 (claude_state) 意味 フックイベント
startup 起動時 SessionStart
thinking 思考中 UserPromptSubmit / PostToolUse
idle 待機中 Stop / Notification(idle_prompt)
waiting 入力待ち PermissionRequest / Notification(permission_prompt)
default 非起動時 SessionEnd（タブ色を通常に戻す）

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

環境変数

変数名 説明
CLAUDE_OBSIDIAN_VAULT Obsidian vault パスの上書き（デフォルト: iCloud 上の Notes/Claude Code）

前提条件

  • 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>            # セッションとノートの対応キャッシュ

Yorumlar (0)

Sonuc bulunamadi