hold your voice

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.

install

npm i -g @holdyourvoice/hyv

this automatically configures MCP for Claude Desktop if it's installed.

quick start

# sign in (opens browser)
hyv init

# create your voice profile
hyv new my-voice

# scan a draft for AI patterns
hyv scan draft.md

# generate a rewrite prompt
hyv rewrite draft.md

MCP server

hyv includes a built-in MCP server for Claude Desktop, Claude Code, and other MCP hosts.

# start the MCP server (used by Claude Desktop automatically)
hyv mcp

tools

| tool | description | |------|-------------| | hyv_rewrite | rewrite text to match your voice profile | | hyv_scan | scan text for AI writing patterns | | hyv_profiles | list your voice profiles | | hyv_validate | validate text against a voice profile |

prompts

| prompt | description | |--------|-------------| | hyv-status | show account context, profiles, and usage |

commands

| command | description | |---------|-------------| | 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 mcp | start MCP server | | hyv export [format] | export profile for LLMs | | hyv plan | manage subscription |

voice profiles

profiles are stored in ~/.hyv/profiles/ as markdown files. create one with:

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.

content formats

hyv scan and hyv rewrite detect 220+ AI writing patterns across categories:

• 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)

environment variables

| variable | description | |----------|-------------| | HYV_API_URL | API base URL (default: https://holdyourvoice.com) |

# Staging
HYV_API_URL=https://staging.holdyourvoice.com hyv init

# Local dev
HYV_API_URL=http://localhost:3000 hyv init

license

UNLICENSED — holdyourvoice.com