@filepad/claude-code-hooks

@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.ai

agent-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 --help

The 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.