area:clieffort-mediumenhancementhelp wantedpriority:low
Metriche repository
- Star
- (48.085 star)
- Metriche merge PR
- (Merge medio 11g 1h) (45 PR mergiate in 30 g)
Descrizione
Summary
Add Windsurf IDE/Cascade support to RTK.
How Windsurf hooks work
Windsurf uses pre_run_command hooks in ~/.codeium/windsurf/hooks.json (user-level) or .windsurf/hooks.json (workspace). Hooks receive JSON via stdin with tool_info.command_line but cannot rewrite commands — they can only block (exit 2) or allow (exit 0).
Implementation plan
Since Windsurf hooks can't rewrite commands, RTK support uses two approaches:
- Rules file (
.windsurfrulesor global): Instructions telling Cascade to prefix commands withrtk - Pre-run hook (optional): Log/track commands for
rtk gainanalytics even without rewriting
Files to add
hooks/windsurf-rtk-rules.md— Windsurf rules content (likehooks/rtk-awareness-codex.md)hooks/windsurf-rtk-hook.sh— Optional pre_run_command hook for trackingsrc/init.rs— AddWindsurfvariant toAgentTargetenumsrc/main.rs— Route--agent windsurf
rtk init -g --agent windsurf should:
- Create
~/.codeium/windsurf/rules/rtk.mdwith RTK instructions - Optionally install
pre_run_commandhook in~/.codeium/windsurf/hooks.json - Show status in
rtk init --show
References
- Windsurf Cascade Hooks docs
- Windsurf rules:
.windsurfrulesfile in workspace root or global rules - User config:
~/.codeium/windsurf/