grounded-copy

Output rules and a copy checker for AI agents.

English · 简体中文

Product website · Website source

Try it · Install · Choose a writing mode · How it works · Before and after · More help

grounded-copy

grounded-copy makes your agent state the fact and get to the point, in chat replies and in the documents it writes. A separate mode covers product pages and marketing copy.

Try it

The Claude Code and Codex plugins load the chat rules at the start of every session, with no instruction from you. Start a session and ask your question. In Codex, approve the plugin's hooks the first time the app asks.

With the skill alone, name it in your request, such as "Use grounded-copy to answer."

In a chat app with no plugin support, paste the rules into its custom instructions. Setup says which part to copy.

For product pages or marketing copy, switch to copy mode first.

Install

The installer needs Python 3 and Node.js with npx. It adds the plugin to Claude Code and Codex when it finds them, and installs the skill for other agents through the Skills CLI.

macOS, Linux, WSL, or Git Bash:

curl -fsSL https://raw.githubusercontent.com/HiroHyun/grounded-copy/main/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/HiroHyun/grounded-copy/main/install.ps1 | iex

To install for one agent

Install for	Commands
Claude Code	claude plugin marketplace add HiroHyun/grounded-copyclaude plugin install grounded-copy@hirohyun-plugins -s user
Codex	codex plugin marketplace add HiroHyun/grounded-copycodex plugin add grounded-copy@hirohyun-plugins
Agents supported by the Skills CLI	npx skills add HiroHyun/grounded-copy --skill grounded-copy --yes

Tip The plugins apply the rules in every chat, check the files the agent saves, and save your writing mode. A skill on its own loads when the agent judges it relevant.

See setup for installation checks, updates, Windows help, and removal.

Choose a writing mode

Your choice stays saved after a restart.

Mode	Use it for
chat (default)	Everyday interaction and ordinary document processing.
copy	Product pages, marketing copy, and similar text.
off	Work that needs the original wording or a different writing style.

Claude Code:

/grounded-copy:grounded chat
/grounded-copy:grounded copy
/grounded-copy:grounded off

Use /grounded-copy:grounded to see the current mode.

Codex:

$grounded-profile chat
$grounded-profile copy
$grounded-profile off
$grounded-profile status

Important For a faithful translation, set off first. The rules can otherwise prompt the agent to remove a comparison that belongs to the original text.

How it works

• The plugin loads the rules when a session starts, so the agent's first draft follows them.
• When the agent saves a file, the plugin checks what the save added, and the agent rewrites each flagged sentence.
• A sentence you typed yourself stays as you wrote it.

Before and after

The pattern guide has more examples.

More help

• Setup: installation checks, checking a file, and troubleshooting.
• Writing rules: the instructions the agent reads.
• Pattern guide: phrases to review and sample rewrites.
• Contributing: how to propose changes.
• License: AGPL-3.0-only. NOTICE carries the copyright.