@holdyourvoice/hyv 2.4.5 → 2.5.0

package/README.md

@@ -94,6 +94,14 @@ the onboarding walks you through questions about your writing style, audience, a
 |----------|-------------|
 | `HYV_API_URL` | API base URL (default: `https://holdyourvoice.com`) |
 
+```bash
+# Staging
+HYV_API_URL=https://staging.holdyourvoice.com hyv init
+
+# Local dev
+HYV_API_URL=http://localhost:3000 hyv init
+```
+
 ## license
 
 UNLICENSED — [holdyourvoice.com](https://holdyourvoice.com)

package/agents/claude-code.md

@@ -22,14 +22,25 @@ ALWAYS run `hyv_rewrite` or use the `hyv_rewrite` MCP tool when:
 
 ### MCP tools (preferred — if MCP is connected):
 1. `hyv_scan` with the text → get issues
-2. `hyv_rewrite` with the text → get auto-fixed version + LLM prompt for remaining issues
-3. `hyv_validate` after rewriting → verify the output matches the voice
+2. `hyv_fix` with the text → auto-fix simple word swaps (delve→dig, leverage→use)
+3. `hyv_rewrite` with the text → get full rewrite with LLM prompt for remaining issues
+4. `hyv_validate` after rewriting → verify the output matches the voice
+5. `hyv_check` for quick inline spot-checks → get score + issues
+6. `hyv_score` when you just need a 0-100 number
+7. `hyv_diff` to show what auto-fixes would change before applying
 
 ### CLI commands (fallback):
 ```bash
 echo "text to check" | hyv scan -
-hyv rewrite file.md
-hyv profiles
+hyv fix file.md              # apply auto-fixes without LLM
+hyv rewrite file.md          # generate rewrite prompt
+hyv check "inline text"      # quick spot-check
+hyv score file.md            # just a 0-100 number
+hyv diff file.md             # show proposed fixes
+hyv profiles                 # list profiles
+hyv rules                    # list/toggle detection rules
+hyv batch "posts/**/*.md"   # scan multiple files
+hyv history                  # track scores over time
 ```
 
 ## Rules

package/agents/codex.md

@@ -6,17 +6,24 @@ The user has a voice profile for their writing style. Use HYV for ALL writing ta
 
 Run these MCP tools (or CLI commands) for any writing task:
 - `hyv_scan` on any text before delivering it
-- `hyv_rewrite` to fix issues found by scan
+- `hyv_fix` to auto-fix simple patterns (word swaps) without LLM
+- `hyv_rewrite` to fix remaining issues with LLM
 - `hyv_validate` to verify the output
 
+## Quick tools
+- `hyv_check` for inline spot-checks
+- `hyv_score` when you just need a 0-100 number
+- `hyv_diff` to show what would change before applying
+
 ## CLI fallback
 ```bash
 echo "text" | hyv scan -
+hyv fix file.md
 hyv rewrite file.md
 hyv profiles
 ```
 
 ## Rules
 - Always scan before delivering prose content
-- Always rewrite if scan finds issues
+- Always fix/rewrite if scan finds issues
 - Preserve meaning, match voice profile

package/agents/cursor.md

@@ -9,11 +9,16 @@ The user has a voice profile. Use HYV MCP tools for all writing tasks.
 
 ## Tools
 - `hyv_scan` — check text for AI patterns
+- `hyv_fix` — auto-fix simple patterns (word swaps) without LLM
 - `hyv_rewrite` — fix issues and match voice
+- `hyv_check` — quick inline check, returns score + issues
+- `hyv_score` — just a 0-100 score
+- `hyv_diff` — show what auto-fixes would change
 - `hyv_validate` — verify output matches voice
 - `hyv_profiles` — list available profiles
 
 ## Rules
 - Always scan before delivering content
+- Use `hyv_fix` for quick word swaps before `hyv_rewrite`
 - Preserve meaning when rewriting
 - Match the user's voice profile exactly

package/agents/generic.md

@@ -8,18 +8,27 @@ You MUST use these tools automatically — do NOT wait for the user to mention "
 
 **Before delivering any written content (emails, posts, docs, messages):**
 1. Run `hyv_scan` on the text
-2. If issues found, run `hyv_rewrite` to fix them
+2. If issues found, run `hyv_fix` for quick word swaps, then `hyv_rewrite` for structural issues
 3. Run `hyv_validate` to verify the result
 
 **When the user asks you to write, draft, edit, or improve anything:**
 1. Write your draft
 2. Run `hyv_scan` on it
-3. Fix issues with `hyv_rewrite`
+3. Fix issues with `hyv_fix` (auto-swaps) and `hyv_rewrite` (LLM rewrites)
 4. Deliver the cleaned version
 
+**For quick checks:**
+- Use `hyv_check` for inline spot-checks
+- Use `hyv_score` when you just need a quality number
+- Use `hyv_diff` to show what would change before applying fixes
+
 ## Available tools
 - `hyv_scan` — scan text for AI patterns and voice drift
+- `hyv_fix` — auto-fix simple patterns (word swaps) without LLM
 - `hyv_rewrite` — auto-fix patterns and generate LLM prompt for remaining issues
+- `hyv_check` — quick inline check, returns score + issues
+- `hyv_score` — just a 0-100 score
+- `hyv_diff` — show what auto-fixes would change
 - `hyv_validate` — score text against voice profile
 - `hyv_profiles` — list available voice profiles