use hyv in codex

install hyv, merge voice rules into ~/.codex/AGENTS.md, restart codex, then have it run hyv scan.

updated jul 11, 2026 app guides no images
quick answer

install → hyv doctor --fix-agents → restart codex → paste the prompt.

use hyv in codexinstall → connect mcp → copy the prompt into your ai app

use this for

  • you use openai codex as a terminal or ide agent

steps

  1. curl -fsSL https://holdyourvoice.com/install.sh | bash
    mac/linux: curl -fsSL https://holdyourvoice.com/install.sh | bash
  2. irm https://holdyourvoice.com/install.ps1 | iex
    windows: irm https://holdyourvoice.com/install.ps1 | iex
  3. hyv doctor --fix-agents
  4. restart codex
  5. paste the prompt below before your writing task

copy this prompt

Paste into any chat in codex 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

  1. ask codex: run hyv scan on this sentence: In today's fast-paced digital landscape, we are excited to unveil.

details to know

  • hyv merges a hold-your-voice block into ~/.codex/AGENTS.md without deleting your other rules
  • this is rules-only — hyv does not auto-add an mcp_servers.hyv entry to ~/.codex/config.toml
  • codex should run the hyv cli (hyv scan …) when the rules fire

limits and edge cases

  • if the hyv block is missing: hyv doctor --fix-agents
  • advanced users can add a codex mcp server themselves with codex mcp add — not required for this guide
ready to try it on your own drafts?get started for $1 →