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 .prs files trigger prs 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 hooks
prs hooks install

# Install hooks for Claude Code only
prs hooks install claude

# Install hooks for Cursor only
prs hooks install cursor

# Remove hooks from all detected tools
prs hooks uninstall

# Remove hooks from a specific tool
prs hooks uninstall windsurf