@filepad/claude-code-hooks
v0.1.3
Published
Filepad Claude Code hook adapter — PreToolUse/PostToolUse/Stop hooks for live contract enforcement.
Maintainers
Readme
@filepad/claude-code-hooks
Claude Code hook adapter for Filepad Agent Access.
This package is runtime-specific. It is only installed by Claude Code pairing profiles and should not be used for Codex, OpenClaw, Cursor, Windsurf, or generic MCP hosts.
Usage
The normal path is to run the Filepad pairing command generated by the app:
npx -y @filepad/agent-connect@latest pair <PAIRING_CODE> --runtime claude-code --base-url https://api.filepad.aiagent-connect writes Claude Code hook settings that call this adapter through
the command supplied by Filepad's Claude Code runtime profile.
Direct Diagnostics
npx -y @filepad/claude-code-hooks@latest --helpThe hook adapter reads credentials from FILEPAD_HOOKS_CREDENTIALS_PATH, which
is written by @filepad/agent-connect during pairing.
Contract Verification Boundary
This package does not install, spawn, or supervise Guardian.
Contract verification is owned by a separate runtime-adapter/Guardian setup flow. Claude Code hooks may surface contract state and enforce backend decisions, but they must not silently pretend Guardian is active when the Guardian package is missing.
