macOS
brew install claude-hookslocal Homebrew formula metadata
brew
claude-hooks のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。
インストール
brew install claude-hookslocal Homebrew formula metadata
概要
Hook system for Claude Code
履歴
claude-hooks is a TypeScript-oriented setup tool for Claude Code hooks. Its official README describes it as a CLI that generates `.claude/settings.json` hook configuration and typed TypeScript handler files for Claude Code lifecycle events.
The npm package was first published in July 2025, after Claude Code's hook system had become a documented extension point. The project focuses on one friction point in that system: turning JSON hook payloads and shell-command handlers into a typed TypeScript development environment.
The README documents generated files under `.claude/hooks/`, including `index.ts`, `lib.ts`, and `session.ts`, plus `.claude/settings.json`. It also requires Node.js 18+ for the CLI and Bun for running hooks.
Distribution is source-backed through npm and Homebrew. The npm registry records 32 versions and published version 2.4.0, while Homebrew packages the same 2.4.0 release from the npm registry.
The evidence supports a niche but clear role: claude-hooks is not a general Claude Code replacement; it is a helper for users who are already adopting Claude Code's official hook lifecycle and want TypeScript types and scaffolding.
Users run `npx claude-hooks` or install it globally with npm, then run `claude-hooks`. The tool creates Claude Code hook configuration and TypeScript handlers that can inspect typed payloads for events such as PreToolUse, PostToolUse, Notification, and Stop.
The official Claude Code hooks reference documents the underlying event model, including command, HTTP, prompt, and MCP hooks, matcher groups, JSON stdin payloads, and hook decisions. claude-hooks builds on that official mechanism.
claude-hooks is package-nerd interesting because it packages a type layer around an AI-agent lifecycle API. Instead of every team copying shell scripts and JSON snippets, it gives the hook surface a generated project structure and a package-manager install path.
It also shows how fast companion packages formed around Claude Code's configuration files: the package's value is not the hook runtime itself, but the typed developer experience around an official extension point.
セキュリティ状態
narrow executable package without higher-risk signals.
リスク グリーン · 信頼度 低 · appliance
エージェントに無人実行させる前に、このツールが平文の認証情報を読むか、リモート状態を書き込むか、成果物を公開するか、プラグインを起動するかを確認してください。
local files
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Config paths the tool may read or write during local use.
.claude/settings.json実行可能ファイル
| コマンド | 種類 | 公開範囲 | メモ |
|---|---|---|---|
claude-hooks | cli | グローバル実行可能ファイル |
鮮度
これらの信号は、ページ生成時期、パッケージマネージャの活動、上流リリース比較を分けて示します。バージョン遅れは、証拠 URL と比較可能なバージョンがある場合だけ警告されます。
https://github.com/johnlindquist/claude-hooks
インストールメタデータ
| パッケージキー | brew:claude-hooks |
|---|---|
| バージョン | 2.4.0 |
| パッケージマネージャ | Homebrew |
| パッケージマネージャページ | https://formulae.brew.sh/formula/claude-hooks |
| ホームページ | https://github.com/johnlindquist/claude-hooks |
| リポジトリ | https://github.com/johnlindquist/claude-hooks |
| 上流ドキュメント | https://code.claude.com/docs/en/hooks |
| ライセンス | MIT |
| ソースアーカイブ | https://registry.npmjs.org/claude-hooks/-/claude-hooks-2.4.0.tgz |
| 依存関係 | node |
| Bottle | 利用可能 (対象 all) |
| Homebrew post-install | 未定義 |
| サービス | 宣言なし |
レジストリ情報
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | claude-hooks |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
ソース経路
このページは scripts/generate-pkg-sqlite.py が生成した非公開のパッケージ SQLite アーティファクトから av-web によって提供されます。
View the package source record on GitHub.