polyhook 0.1.5

polyhook Python SDK — write AI coding agent hooks once, run them everywhere

polyhook — Python SDK

Write AI coding agent hooks once. Run them everywhere.

polyhook detects which AI coding tool invoked your hook binary, deserializes the event into a normalized struct, and serializes your response back in the format that tool expects. Your hook runs unchanged whether Claude Code, Cursor, Windsurf, Cline, or Amp invoked it.

Install

pip install polyhook

Quick Start

import sys
import re
import polyhook

event = polyhook.read()

if (
    event.tool == "bash"
    and re.search(r"rm\s+-rf\s+/", event.input.get("command", "") if event.input else "")
):
    polyhook.respond(polyhook.block("Refusing to delete from root"))
else:
    polyhook.respond(polyhook.approve())

More examples: examples/

Supported Tools

Tool	Status
Claude Code	✅ Supported
Cursor	✅ Supported
Windsurf	✅ Supported
Cline	✅ Supported
Amp	✅ Supported
Continue	🚧 In progress
Aider	🚧 In progress
Copilot	📋 Planned

Documentation

Full docs and API reference: https://github.com/tupe12334/polyhook

License

MIT