prs hooks
Scaffold and remove AI tool hook configurations that wire prs hook pre-edit and prs hook post-edit into the native hook system of each supported tool.
Synopsis
prs hooks <action> [tool] [options]Description
prs hooks manages the hook configuration files that connect PromptScript to the event system of your AI coding tool. After installation, the tool calls prs hook pre-edit before any file write and prs hook post-edit after any file write, enabling:
- Auto-compilation - supported AI tool writes to
.prsfiles triggerprs compile. - Output protection — writes to generated files are blocked with an actionable error.
This command does not compile language-level @hooks. Those definitions use
target formatter output such as .factory/hooks.json and
.github/hooks/promptscript.json. The Copilot installer path
.github/hooks/promptscript-vscode.json configures VS Code Agent Hooks only.
Actions
install
prs hooks install [tool] [options]Writes hook configuration for the specified tool, or for all auto-detected tools when no tool name is given.
Arguments
| Argument | Description |
|---|---|
[tool] | Tool name to install for. Omit to auto-detect. |
Supported tool names
claude, factory, cursor, windsurf, cline, copilot, gemini
Options
| Option | Description |
|---|---|
--all | Accepted for compatibility; current behavior still uses auto-detection |
Auto-detection logic
When no tool name is given, prs hooks install checks the project root for files associated with
each tool:
| Tool | Detected by presence of |
|---|---|
| Claude Code | .claude/ |
| Factory AI | .factory/ |
| Cursor | .cursor/ |
| Windsurf | .windsurf/ |
| Cline | .clinerules |
| Copilot | .github/hooks/ or .github/copilot-instructions.md |
| Gemini CLI | .gemini/ |
If none are found, the command reports an error and exits with code 1. Specify a tool name to install its integration explicitly.
Config files written
| Tool | Config file |
|---|---|
| Claude Code | .claude/settings.json |
| Factory AI | .factory/hooks.json |
| Cursor | .cursor/hooks.json |
| Windsurf | .windsurf/hooks.json |
| Cline | .clinerules/hooks/prs-{pre,post}-edit.sh |
| Copilot | .github/hooks/promptscript-vscode.json |
| Gemini CLI | .gemini/settings.json |
If a config file already exists, the command merges the hook entries rather than overwriting the whole file.
prs hooks install factory also migrates unambiguous hook entries from the
legacy .factory/settings.json hooks section. Unrelated settings are
preserved. The command refuses partial migrations when it finds unknown event
names or ambiguous entries, so those entries can be reviewed manually.
The Factory compile target performs the same migration automatically when
.factory/hooks.json does not exist. Use prs compile --dry-run to preview it
or prs compile --no-migrate-factory-hooks to keep warning-only behavior.
prs hooks install factory remains available for explicit installation and
migration.
uninstall
prs hooks uninstall [tool]Removes PromptScript hook entries from the config file of the specified tool, or from all auto-detected tools when no tool name is given.
Arguments
| Argument | Description |
|---|---|
[tool] | Tool name to uninstall for. Omit to uninstall all detected. |
For JSON integrations, uninstall removes PromptScript entries and preserves the settings file. Cline hook scripts are removed only when they match PromptScript’s ownership marker or legacy installer content; unowned scripts are preserved.
Options
| Option | Short | Description |
|---|---|---|
--all | Accepted for compatibility; current behavior still uses auto-detection |
Examples
# Auto-detect tools and install hooksprs hooks install
# Install hooks for Claude Code onlyprs hooks install claude
# Install hooks for Cursor onlyprs hooks install cursor
# Remove hooks from all detected toolsprs hooks uninstall
# Remove hooks from a specific toolprs hooks uninstall windsurfSee Also
prs hook— the hook handler invoked at runtime- Hooks Guide - setup, generated configuration, and troubleshooting