use hyv in windsurf
install hyv, install always-on cascade rules, restart windsurf, then have cascade run hyv scan.
quick answer
install → hyv doctor --fix-agents → restart windsurf → paste the prompt.
use hyv in windsurfinstall → connect mcp → copy the prompt into your ai app
use this for
- you use windsurf cascade for writing and docs
steps
- mac/linux: curl -fsSL https://holdyourvoice.com/install.sh | bash
curl -fsSL https://holdyourvoice.com/install.sh | bash - windows: irm https://holdyourvoice.com/install.ps1 | iex
irm https://holdyourvoice.com/install.ps1 | iex hyv doctor --fix-agents- restart windsurf
- paste the prompt below into cascade
copy this prompt
Paste into any chat in windsurf after the steps above. On mcp hosts, tools must already be connected; on rules/skill hosts the agent should run the hyv cli.
For publishable copy such as a social post, newsletter, blog, landing page, campaign, or external audience-facing email, check it with hold your voice. Run `hyv scan` on the draft (or follow the hyv skill/rules in this app). For routine chat, analysis, planning, coding, and internal engineering updates, do not run hyv unless I explicitly ask.verify it works
- ask cascade: run hyv scan on this markdown paragraph
details to know
- hyv writes ~/.windsurf/rules/hyv.md with trigger: always_on
- this is rules-only — hyv does not auto-write windsurf mcp_config.json
- cascade should run the hyv cli (hyv scan …) when the rule applies
limits and edge cases
- restart windsurf after rule changes
- if the rule is missing: hyv doctor --fix-agents
ready to try it on your own drafts?get started for $1 →