Cc Tools

cc工具

CLI伴侣 克劳德代码 它自动化了钩子事件处理、并行lint/test验证、MCP服务器管理、通知、会话跟踪和每个目录跳过配置。

它做什么

cc工具插入Claude Code的钩子系统，在每个钩子事件上运行处理程序——会话生命周期、工具使用、通知和上下文压缩。当配置为 PostToolUse 钩子 validate 命令拦截文件编辑，并在接受更改之前并行运行项目的linter和测试套件。如果任一操作失败，工具调用将被阻止，并显示格式化的错误消息。

除了验证之外，cc工具还提供：

• 吊钩调度 --一个处理程序注册表，将所有Claude Code钩子事件路由到专门构建的处理程序
• 通知 --音频播放、macOS桌面警报和安静时间的ntfy推送通知
• 会话跟踪 --存储会话元数据，支持别名和搜索
• 观测记录 --记录工具使用事件进行分析
• MCP管理 --启用/禁用MCP服务器集成
• 跳过注册表 --lint、test或两者的每个目录跳过规则

安装

需要Go 1.26+和 任务.

task build      # Build to ./bin/cc-tools
task install    # Copy to $GOPATH/bin

命令

cc-tools  [arguments]

钩子集成

添加到您的克劳德代码设置(~/.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [{ "type": "command", "command": "cc-tools validate" }]
      },
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "SessionStart": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "Stop": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "Notification": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ],
    "PreCompact": [
      {
        "matcher": "*",
        "hooks": [{ "type": "command", "command": "cc-tools hook" }]
      }
    ]
  }
}

这 hook 命令从stdin读取事件JSON，分派给已注册的处理程序，并返回结构化输出。这 validate command发现项目的lint/test命令并同时运行它们。

注册处理程序

例子

# Dispatch a hook event (stdin receives event JSON)
echo '{"hook_event_name":"Notification","title":"Done","message":"Tests passed"}' | cc-tools hook

# Validate a file edit
echo '{"tool_name":"Edit","tool_input":{"file_path":"main.go"}}' | cc-tools validate

# Manage sessions
cc-tools session list
cc-tools session info 
cc-tools session search "auth refactor"
cc-tools session alias set latest 

# Manage MCP servers
cc-tools mcp list
cc-tools mcp enable jira
cc-tools mcp disable jira

# Skip validation for a directory
cc-tools skip lint /path/to/generated
cc-tools skip list

# Configure settings
cc-tools config set validate.timeout 120
cc-tools config get validate.timeout
cc-tools config list

配置

设置存储在 ~/.config/cc-tools/config.json.

调试日志将写入 ~/.cache/cc-tools/debug/.

发展

task doctor         # Check required tools
task tools-install  # Install gotestsum, golangci-lint, goimports, mockery
task build          # Build binary
task test           # Fast tests (-short, 30s)
task lint           # golangci-lint
task check          # fmt + lint + test-race (run before committing)
task test-race      # Tests with race detector
task mocks          # Regenerate mocks
task coverage       # HTML coverage report

许可证

看 许可证 了解详情。