CC Hook

Update

Claude Code's official hooks function has released.

So cc-hook is no longer needed; use official hooks!

cc-hook

A lightweight wrapper specifically for claude code to trigger notifications or custom commands when tasks complete or permissions are requested.

What is cc-hook?

cc-hook wraps around claude executions and monitors its output. It automatically triggers commands or notifications based on regex patterns you define. Perfect for staying informed without constantly watching the terminal!

Installation

Just run:

Usage

Run your usual claude command with cc-hook:

Configuration

You can check your default configuration path with:

Then you can edit it and configure cc-hook.

By default, the configuration is empty, so you'll need to define your own hooks to trigger notifications or commands.

Here’s a quick example to get started:

Customize your regex patterns and commands as needed.

Commands

* Show the config file path:

* Use a custom config file:

Why use cc-hook?

* Never miss important prompts from claude code.
* Get notified instantly when tasks finish.
* Lightweight, customizable, and straightforward.

Contributing

Contributions, issues, and feature requests are all welcome!

In fact, this tool is 100% made by claude code.
So the code style and comments may be a little strange. So even small refactorings and comment fixes are welcome :)

License

MIT