@holdyourvoice/hyv 2.8.1 → 2.8.2

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable CLI changes. Also mirrored to [holdyourvoice.com/changelog](https://holdyourvoice.com/changelog) for user-facing releases.
 
+## [2.8.2] — 2026-06-12
+
+### Added
+- Phase 5 marketing: `hyv content` (blog outlines, CI snippets, share templates)
+- `hyv plan --free` — canonical free vs paid matrix in terminal
+- `cli/assets/FREE-PAID.md` — shipped free/paid reference
+- Scan funnel hints + `scan_complete` / `init_success` telemetry events
+- Landing + npm README: npx-first install, free CLI section, SEO keywords
+
+### Improved
+- Postinstall, welcome, plan, and init flows promote npx + free local tier
+- npm package description optimized for cursor/claude/MCP discovery
+
 ## [2.8.1] — 2026-06-12
 
 ### Fixed

package/README.md

@@ -2,7 +2,14 @@
 
 make your ai agent sound exactly like you.
 
-`hyv` is a CLI-first voice gate layer for AI workflows. it scans text for AI writing patterns, builds a voice profile from your own writing, and rewrites drafts to match your personal style.
+`@holdyourvoice/hyv` is a CLI-first voice gate for AI workflows. scan drafts for AI writing patterns locally (offline, no API), wire it into cursor/claude via MCP, and unlock profile-aware rewrites when you subscribe.
+
+**Try without installing:**
+
+```bash
+npx @holdyourvoice/hyv welcome
+npx @holdyourvoice/hyv scan draft.md
+```
 
 ## install
 
@@ -10,40 +17,63 @@ make your ai agent sound exactly like you.
 npm i -g @holdyourvoice/hyv
 ```
 
-this automatically configures MCP for Claude Desktop if it's installed.
+postinstall auto-configures MCP for claude desktop, cursor, windsurf, and claude code when those apps are present.
 
-## quick start
+## free vs paid
+
+| free forever (local, no account) | paid unlocks |
+|----------------------------------|--------------|
+| `hyv scan`, `fix`, `check`, `score`, `diff`, `batch`, `watch` | voice profiles synced from your account |
+| `hyv mcp` — agent tools (`hyv_scan`, `hyv_clean`, …) | learning loop: `hyv reinforce`, `hyv add` |
+| `hyv welcome`, `hyv doctor`, `hyv content` | profile-aware `hyv rewrite` prompts |
+| 30+ free web tools at [holdyourvoice.com/tools](https://holdyourvoice.com/tools) | hybrid server analysis (`hyv scan --server`, MCP `hyv_analyze`) |
+| public voice profiles + blog | multiple profiles, team voices, dashboard |
 
 ```bash
-# sign in (opens browser)
-hyv init
+hyv plan --free    # full matrix in the terminal
+hyv welcome        # live demo + every free capability
+```
 
-# create your voice profile
-hyv new my-voice
+local scan never calls an LLM. your text stays on your machine.
+
+## quick start
 
-# scan a draft for AI patterns
+```bash
+# instant demo — no auth
+npx @holdyourvoice/hyv welcome
+
+# scan a draft offline
 hyv scan draft.md
 
-# generate a rewrite prompt
+# sign in when you want profiles + learning
+hyv init
+hyv new my-voice
+
+# generate a rewrite prompt (profile-aware when subscribed)
 hyv rewrite draft.md
 ```
 
-## MCP server
-
-`hyv` includes a built-in MCP server for Claude Desktop, Claude Code, Cursor, Windsurf, and Codex.
+## npx (no global install)
 
 ```bash
-# setup instructions for all supported agents
-hyv mcp --setup
+npx @holdyourvoice/hyv welcome
+npx @holdyourvoice/hyv scan draft.md
+npx @holdyourvoice/hyv fix draft.md
+npx @holdyourvoice/hyv init
+npx @holdyourvoice/hyv mcp --setup
+```
+
+## MCP server
 
-# health check (tools, demo pipeline, profile)
-hyv mcp --test
+`hyv mcp` runs a stdio MCP server for claude desktop, claude code, cursor, windsurf, codex, and command code.
 
-# start the MCP server (stdio — used by Claude Desktop automatically)
-hyv mcp
+```bash
+hyv mcp --setup    # copy-paste config for every agent
+hyv mcp --test     # health check (tools, demo pipeline, profile)
+hyv mcp            # start server (stdio)
 ```
 
-Postinstall copies agent rules to `~/.cursor/rules/hyv.md`, `~/.claude/commands/hyv.md`, etc. Re-run anytime:
+postinstall copies agent rules to `~/.cursor/rules/hyv.md`, `~/.claude/commands/hyv.md`, etc. re-run anytime:
 
 ```bash
 hyv doctor --fix-agents
@@ -62,74 +92,88 @@ hyv doctor --fix-agents
 | `hyv_validate` | verify text against voice profile |
 | `hyv_profiles` | list cached or account profiles |
 
-### prompts
-
-| prompt | description |
-|--------|-------------|
-| `hyv-status` | account mode, profiles, recommended tool flow |
-
 ### agent workflow
 
 1. `hyv_scan` or `hyv_analyze` on draft text
 2. `hyv_clean` or `hyv_fix` → `hyv_rewrite` → `hyv_validate`
-3. After user accepts edits: `hyv reinforce --last` (CLI learning loop)
+3. after user accepts edits: `hyv reinforce --last` (CLI learning loop)
+
+## CI / pre-commit
+
+block AI-slop before merge:
+
+```bash
+hyv content ci    # full github actions + pre-commit snippets
+```
+
+github actions:
+
+```yaml
+- run: npx @holdyourvoice/hyv@latest scan content/ --fail-on-hit
+```
 
 ## commands
 
 | command | description |
 |---------|-------------|
+| `hyv` | condensed welcome (no args) |
+| `hyv welcome` / `hyv free` | free demo + capability tour |
+| `hyv scan <file>` | scan text for AI patterns |
+| `hyv fix <file>` | auto-swap fixable patterns |
+| `hyv check <text>` | quick pass/fail check |
 | `hyv init` | authenticate with hold your voice |
-| `hyv status` | show CLI and auth status |
 | `hyv new <name>` | create a voice profile |
-| `hyv profiles` | list voice profiles |
-| `hyv rename <name>` | rename a voice profile |
-| `hyv scan <file>` | scan text for AI patterns |
 | `hyv rewrite <file>` | generate rewrite prompt |
-| `hyv sync` | sync profiles from server |
-| `hyv doctor` | diagnose and fix issues |
+| `hyv content [topic]` | blog outlines, CI snippets, share templates |
+| `hyv plan --free` | free vs paid matrix |
 | `hyv mcp` | start MCP server |
 | `hyv export [format]` | export profile for LLMs |
-| `hyv plan` | manage subscription |
-| `hyv upgrade` | install latest global CLI |
-| `hyv welcome` | free demo + capability tour |
 | `hyv reinforce --last` | learn from last fix session |
+| `hyv doctor` | diagnose and fix issues |
+| `hyv upgrade` | install latest global CLI |
 
 ## voice profiles
 
-profiles are stored in `~/.hyv/profiles/` as markdown files. create one with:
+profiles live in `~/.hyv/profiles/` as markdown. create one with:
 
 ```bash
 hyv new my-voice
 ```
 
-the onboarding walks you through questions about your writing style, audience, and tone. the profile is saved locally and synced to the server.
+onboarding walks through your style, audience, and tone. profiles sync to the server when you're on a paid plan.
 
 ## content formats
 
-`hyv scan` and `hyv rewrite` detect 220+ AI writing patterns across categories:
+`hyv scan` detects 220+ AI writing patterns:
+
+- **ai-slop** — delve, leverage, tapestry, pivotal, foster
+- **formulaic** — firstly, moreover, in conclusion
+- **voice-drift** — arguably, perhaps, some might say
+- **structure** — antithesis, signpost claims, lesson setups
 
-- **ai-slop** — overused AI words (delve, leverage, tapestry, pivotal, foster)
-- **formulaic** — connector words (firstly, moreover, in conclusion)
-- **voice-drift** — hedging language (arguably, perhaps, some might say)
-- **structure** — AI structural tells (antithesis, signpost claims, lesson setups)
+paid profiles add never-list bans, learned patterns, anchors, and cadence scoring.
 
 ## environment variables
 
 | variable | description |
 |----------|-------------|
 | `HYV_API_URL` | API base URL (default: `https://holdyourvoice.com`) |
-| `HYV_LOCAL_ONLY` | Force offline mode (`1` or `true`) |
-| `HYV_TELEMETRY` | Log MCP tool usage to `~/.hyv/telemetry/` (`1` to enable) |
-| `HYV_POSTINSTALL_QUIET` | Suppress postinstall output (`1`) |
+| `HYV_LOCAL_ONLY` | force offline mode (`1` or `true`) |
+| `HYV_TELEMETRY` | log funnel events to `~/.hyv/telemetry/` (`1` to enable) |
+| `HYV_POSTINSTALL_QUIET` | suppress postinstall output (`1`) |
 
 ```bash
-# Staging
 HYV_API_URL=https://staging.holdyourvoice.com hyv init
-
-# Local dev
-HYV_API_URL=http://localhost:3000 hyv init
 ```
 
+## links
+
+- [npm package](https://www.npmjs.com/package/@holdyourvoice/hyv)
+- [free tools](https://holdyourvoice.com/tools)
+- [pricing](https://holdyourvoice.com/#pricing)
+- [blog](https://holdyourvoice.com/blog)
+- [community](https://holdyourvoice.com/community)
+
 ## license
 
-UNLICENSED — [holdyourvoice.com](https://holdyourvoice.com)
+UNLICENSED — [holdyourvoice.com](https://holdyourvoice.com)

package/assets/FREE-PAID.md

@@ -0,0 +1,46 @@
+# free vs paid — @holdyourvoice/hyv
+
+## free forever (local + web)
+
+**CLI (offline, no account)**
+
+- `hyv scan`, `fix`, `check`, `score`, `diff`, `batch`, `watch`
+- `hyv rules`, `history`, `demo`, `doctor`, `upgrade`
+- `hyv export` (local profile markdown)
+- `hyv mcp` — agent tools (`hyv_scan`, `hyv_clean`, `hyv_analyze`, …)
+- `hyv welcome` / `hyv free` — capability tour + live demo
+- `hyv content` — blog & share templates
+- `hyv plan --free` — this matrix in the terminal
+
+**Try without installing**
+
+```bash
+npx @holdyourvoice/hyv welcome
+npx @holdyourvoice/hyv scan draft.md
+npx @holdyourvoice/hyv fix draft.md
+npx @holdyourvoice/hyv init
+npx @holdyourvoice/hyv mcp
+```
+
+**Web (30+ free tools)**
+
+- https://holdyourvoice.com/tools
+- headline analyzer, brand voice audit, readability checker, email subject scorer, persona builder, and more
+- public profiles: https://holdyourvoice.com/profiles
+- blog: https://holdyourvoice.com/blog
+
+## paid unlocks
+
+- voice profiles synced from your account (never-list, anchors, learned patterns)
+- learning loop: `hyv reinforce`, `hyv add`
+- profile-aware rewrite prompts (`hyv rewrite`)
+- hybrid server analysis (`hyv scan --server`, MCP `hyv_analyze`)
+- multiple profiles + team voices (team plan)
+- dashboard at https://holdyourvoice.com/dashboard
+
+First month $1 → https://holdyourvoice.com/#pricing
+
+```bash
+hyv init
+hyv plan --upgrade
+```