# claude-hooks を Homebrew でインストール

claude-hooks のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:claude-hooks
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install claude-hooks
```

  証拠: local Homebrew formula metadata

## パッケージ情報

- **パッケージキー:** brew:claude-hooks
- **パッケージマネージャ:** Homebrew
- **パッケージマネージャページ:** <https://formulae.brew.sh/formula/claude-hooks>
- **バージョン:** 2.4.0
- **ソース概要:** Hook system for Claude Code
- **ホームページ:** <https://github.com/johnlindquist/claude-hooks>
- **リポジトリ:** <https://github.com/johnlindquist/claude-hooks>
- **ライセンス:** MIT
- **ソースアーカイブ:** <https://registry.npmjs.org/claude-hooks/-/claude-hooks-2.4.0.tgz>
- **生成日時:** 2026-08-04T22:13:35+00:00

## 実行可能ファイル

- claude-hooks (cli)
- claude-hooks (エイリアス)

## 依存関係

- node

## インストール挙動

- post-install フック: 未定義
- Bottle: 利用可能 対象 all

## バージョンと鮮度

- ページ生成日: 2026-08-04
- マネージャ版: 2.4.0
- ローカルデータ: OK
- 上流リポジトリ: https://github.com/johnlindquist/claude-hooks
- 情報: No package-manager update timestamp was available.
- 情報: No cached GitHub release or tag data was available.
## プロジェクトの歴史と使われ方

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.

### タイムライン

- 2025-07: npm registry records the first `claude-hooks` publication.
- 2025-08: npm registry records published version 2.4.0 after 32 published versions.
- 2026: Homebrew formula `claude-hooks` packages version 2.4.0 from the npm registry.

### Related projects

- Claude Code's official hooks system is the extension point claude-hooks configures.
- Bun is required by the README for running generated hooks.
- TypeScript is the language layer used for typed payloads and handlers.
- claude-cmd and Claude Code Templates are related Claude Code configuration companion tools.

### ソース

- <https://github.com/johnlindquist/claude-hooks>
- <https://registry.npmjs.org/claude-hooks>
- <https://formulae.brew.sh/api/formula/claude-hooks.json>
- <https://code.claude.com/docs/en/hooks.md>


## セキュリティノート

narrow executable package without higher-risk signals.

- **Geiger リスク:** グリーン / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

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.


## Configuration files

- Unix: .claude/settings.json
## ソースデータベース詳細

- **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:** stable


## 関連リンク

- [Source-control packages](https://pkg.so/ja/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://pkg.so/ja/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://pkg.so/ja/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://pkg.so/ja/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [node](https://pkg.so/ja/brew/node/) - Runtime dependency declared by Homebrew.
- [claudekit](https://pkg.so/ja/brew/claudekit/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents, hooks.
- [claude-code-templates](https://pkg.so/ja/brew/claude-code-templates/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents, hooks.
- [ccusage](https://pkg.so/ja/brew/ccusage/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [claude-code-router](https://pkg.so/ja/brew/claude-code-router/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [claude-cmd](https://pkg.so/ja/brew/claude-cmd/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [tmuxai](https://pkg.so/ja/brew/tmuxai/) - Shares pkgdb curated category or tags: ai, automation, cli, coding-agents.
- [tweakcc](https://pkg.so/ja/brew/tweakcc/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.
- [omnara](https://pkg.so/ja/brew/omnara/) - Shares pkgdb curated category or tags: ai, claude-code, cli, coding-agents.

## Combined YAML source

View the package source record on GitHub. [combined/claude-hooks.yml](https://github.com/mxcl/pkgdb/blob/main/combined/claude-hooks.yml)


## ソース

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph