Hook Manager

钩子管理器

Discover, install, and manage automation hooks from the bopen-tools collection for Claude Code and Opencode.

发现、安装并管理来自bopen-tools集合的、适用于Claude Code和Opencode的自动化钩子。

Available Hooks

可用钩子列表

Hook	Event	Description	Auto-install
`protect-env-files`	PreToolUse	Blocks edits to .env files (security)	Recommended
`uncommitted-reminder`	Stop	Shows uncommitted changes when agent stops	Optional
`auto-git-add`	PostToolUse	Auto-stages files after edits	Optional
`time-dir-context`	UserPromptSubmit	Adds timestamp/dir/branch to prompts	Optional
`lint-on-save`	PostToolUse	Runs lint:fix after file edits	Optional
`lint-on-start`	SessionStart	Runs linting on session start	Optional
`auto-test-on-save`	PostToolUse	Runs tests after file edits	Optional
`protect-shadcn-components`	PreToolUse	Protects shadcn UI components	Optional

钩子名称	触发事件	描述	安装建议
`protect-env-files`	PreToolUse	阻止对.env文件的编辑（安全防护）	推荐
`uncommitted-reminder`	Stop	当Agent停止运行时，显示未提交的变更	可选
`auto-git-add`	PostToolUse	文件编辑后自动暂存修改	可选
`time-dir-context`	UserPromptSubmit	在提示中添加时间戳/目录/分支信息	可选
`lint-on-save`	PostToolUse	文件编辑后自动运行lint:fix	可选
`lint-on-start`	SessionStart	会话启动时自动运行代码检查	可选
`auto-test-on-save`	PostToolUse	文件编辑后自动运行测试	可选
`protect-shadcn-components`	PreToolUse	保护shadcn UI组件文件不被修改	可选

Installing a Hook

安装钩子

Hooks are installed by copying the JSON config to your agent's hooks directory:

钩子的安装方式是将JSON配置文件复制到Agent的钩子目录中：

Claude Code

bash

undefined

bash

undefined

Create hooks directory if needed

若需要则创建钩子目录

mkdir -p ~/.claude/hooks

Copy hook from plugin cache

从插件缓存中复制钩子文件

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/<hook-name>.json ~/.claude/hooks/

undefined

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/<hook-name>.json ~/.claude/hooks/

undefined

Opencode

bash

undefined

bash

undefined

Create hooks directory if needed

若需要则创建钩子目录

mkdir -p ~/.opencode/hooks

Copy hook from plugin cache

从插件缓存中复制钩子文件

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/<hook-name>.json ~/.opencode/hooks/


Then restart your agent to load the hook.

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/<hook-name>.json ~/.opencode/hooks/


然后重启Agent以加载钩子。

Hook Details

钩子详情

protect-env-files (Recommended)

protect-env-files（推荐）

Security hook - Prevents accidental edits to environment files containing secrets.

Blocks:

.env

,

.env.local

,

.env.production

,

.env.staging

Prompts for confirmation if edit attempted
No performance impact

安全防护钩子 - 防止意外编辑包含敏感信息的环境配置文件。

阻止编辑的文件：

.env

,

.env.local

,

.env.production

,

.env.staging

当尝试编辑时会提示确认
无性能影响

uncommitted-reminder

Shows git status when Claude finishes responding if there are uncommitted changes.

Helps prevent forgotten commits
Exit code 2 feeds back to Claude

当Claude结束响应时，若存在未提交的变更则显示git状态。

帮助避免遗忘提交变更
返回退出码2给Claude

auto-git-add

Automatically runs

git add -A

after Write/Edit/MultiEdit operations.

Only stages, never commits
5 second timeout

在执行Write/Edit/MultiEdit操作后自动运行

git add -A

。

仅暂存文件，不会自动提交
超时时间为5秒

time-dir-context

Adds context line to every prompt: timestamp, working directory, git branch.

Example:

Context: 2025-01-24 14:32:15 | /Users/you/project | Branch: main

在每个提示中添加上下文信息行：时间戳、工作目录、git分支。

示例：

Context: 2025-01-24 14:32:15 | /Users/you/project | Branch: main

lint-on-save

Runs

bun lint:fix

after file edits.

Requires project with
```
lint:fix
```
script in package.json
Requires
```
bun
```
and
```
jq
```
Works with statusline for lint count display

文件编辑后运行

bun lint:fix

。

要求项目的package.json中包含
```
lint:fix
```
脚本
需要安装
```
bun
```
和
```
jq
```
可配合状态栏显示代码检查结果数量

lint-on-start

Runs linting when session starts.

Same requirements as lint-on-save

会话启动时运行代码检查。

要求与lint-on-save相同

auto-test-on-save

Runs tests after file edits.

Can be slow on large test suites
Consider project-specific setup

文件编辑后自动运行测试。

在大型测试套件中运行可能较慢
建议根据项目进行特定配置

protect-shadcn-components

Prevents edits to shadcn/ui component files.

Only relevant for projects using shadcn/ui

防止编辑shadcn/ui组件文件。

仅适用于使用shadcn/ui的项目

Installing This Skill

安装本技能

bash

bunx skills add b-open-io/bopen-tools --skill hook-manager

bash

bunx skills add b-open-io/bopen-tools --skill hook-manager

Uninstalling a Hook

卸载钩子

Claude Code:

bash

rm ~/.claude/hooks/<hook-name>.json

Opencode:

bash

rm ~/.opencode/hooks/<hook-name>.json

Restart your agent.

Claude Code：

bash

rm ~/.claude/hooks/<hook-name>.json

Opencode：

bash

rm ~/.opencode/hooks/<hook-name>.json

重启Agent。

Listing Installed Hooks

列出已安装钩子

Claude Code:

bash

ls ~/.claude/hooks/

Opencode:

bash

ls ~/.opencode/hooks/

Claude Code：

bash

ls ~/.claude/hooks/

Opencode：

bash

ls ~/.opencode/hooks/

Quick Install Commands

快速安装命令

Claude Code

bash

undefined

bash

undefined

Security (recommended)

安全防护（推荐）

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/protect-env-files.json ~/.claude/hooks/

Workflow helpers

工作流辅助工具

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/uncommitted-reminder.json ~/.claude/hooks/ cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/auto-git-add.json ~/.claude/hooks/

Context enrichment

上下文信息增强

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/time-dir-context.json ~/.claude/hooks/

Development automation

开发流程自动化

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-save.json ~/.claude/hooks/ cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-start.json ~/.claude/hooks/

undefined

cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-save.json ~/.claude/hooks/ cp ~/.claude/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-start.json ~/.claude/hooks/

undefined

Opencode

bash

undefined

bash

undefined

Security (recommended)

安全防护（推荐）

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/protect-env-files.json ~/.opencode/hooks/

Workflow helpers

工作流辅助工具

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/uncommitted-reminder.json ~/.opencode/hooks/ cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/auto-git-add.json ~/.opencode/hooks/

Context enrichment

上下文信息增强

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/time-dir-context.json ~/.opencode/hooks/

Development automation

开发流程自动化

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-save.json ~/.opencode/hooks/ cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-start.json ~/.opencode/hooks/

undefined

cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-save.json ~/.opencode/hooks/ cp ~/.opencode/plugins/cache/bopen-tools/user/.claude/hooks/lint-on-start.json ~/.opencode/hooks/

undefined

Verifying Installation

验证安装

After installing and restarting your agent:

bash

claude --debug

Look for hook registration messages in the debug output.

安装并重启Agent后：

bash

claude --debug

在调试输出中查找钩子注册信息。

hook-manager

Original

Translation

Hook Manager

钩子管理器

Available Hooks

可用钩子列表

Installing a Hook

安装钩子

Claude Code

Claude Code

Create hooks directory if needed

若需要则创建钩子目录

Copy hook from plugin cache

从插件缓存中复制钩子文件

Opencode

Opencode

Create hooks directory if needed

若需要则创建钩子目录

Copy hook from plugin cache

从插件缓存中复制钩子文件

Hook Details

钩子详情

protect-env-files (Recommended)

protect-env-files（推荐）

uncommitted-reminder

uncommitted-reminder

auto-git-add

auto-git-add

time-dir-context

time-dir-context

lint-on-save

lint-on-save

lint-on-start

lint-on-start

auto-test-on-save

auto-test-on-save

protect-shadcn-components

protect-shadcn-components

Installing This Skill

安装本技能

Uninstalling a Hook

卸载钩子

Listing Installed Hooks

列出已安装钩子

Quick Install Commands

快速安装命令

Claude Code

Claude Code

Security (recommended)

安全防护（推荐）

Workflow helpers

工作流辅助工具

Context enrichment

上下文信息增强

Development automation

开发流程自动化

Opencode

Opencode

Security (recommended)

安全防护（推荐）

Workflow helpers

工作流辅助工具

Context enrichment

上下文信息增强

Development automation

开发流程自动化

Verifying Installation

验证安装