Skip to content
Development
Hook

Hooks

What permafrost runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.

Install
$ npx -y skills add jianzhichun/permafrost --agent claude-code

Ships with permafrost. Installing the plugin gets these hooks.

What fires, and when

SessionStart

Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.

  • Runs session_start.sh.
Read hooks/hooks.json

Where it lives

Read the script before you install anything that runs on your machine. This is the one part of a plugin that acts without being asked.

Ships withpermafrost

Freeze Claude Code's prompt prefix so DeepSeek's automatic cache always hits — alignment proxy + coalescing + keepalive, installable as a CC plugin. Measured 64% cheaper on real Claude Code traffic.

Get the whole plugin, auto-invoked
Stats
18
Stars
0
Views
3
Forks
Maintained
Maintenance
Python
Language
MIT
License
1mo ago
Last commit
1mo ago
Created

Repo: jianzhichun/permafrost