Ditto Agent Setup Package

Ditto's bundled agent integration:

• Ditto MCP server
• Always on instructions to consult Ditto for user-facing copy, without you prompting it.
• /ditto-review: check the current diff's user-facing strings against your styleguide rules and existing Ditto text; returns a fix-list.
• /ditto-audit [path]: check the path for user-facing strings against your styleguide rules and existing Ditto text; returns a fix-list.
• /ditto-spec-audit [component]: (for repos using Ditto specs) audit every instance of a specced component across the codebase against its spec's rules.
• /ditto-spec-component <component>: (for repos using Ditto specs) analyze a component, create or update its Ditto spec file (and specs for child components that lack one), and sync styleguide rules from the platform.
• /ditto-spec-gaps [component]: (for repos using Ditto specs) find copy patterns across component instances that should be styleguide rules but aren't; create approved ones on the platform.

The /ditto-spec-audit, /ditto-spec-component, and /ditto-spec-gaps skills work on repos set up for Ditto Specs. See the agent skills reference for the full explanation of each.

Install

Claude Code CLI

/plugin marketplace add dittowords/ditto-agent-setup
/plugin install ditto@ditto

Restart Claude Code and approve the ditto MCP server (if not approved already).

Then log in: run /mcp, select plugin:ditto:ditto, and choose Authenticate. A browser tab opens for you to log in to Ditto and approve access.

Claude Desktop

Click Customize:

Find the Plugin tab -> Add -> Add marketplace:

Paste https://github.com/dittowords/ditto-agent-setup:

Install Ditto:

Finally, go to Connectors -> Ditto -> Connect/Reconnect to complete authorization:

Cursor

In Cursor Settings go to Plugins and paste https://github.com/dittowords/ditto-agent-setup in the "Search or Paste Link" input. Click on Ditto -> Add to Cursor.

Next go to Tools & MCPs and authenticate with the ditto Plugin MCP Server.

Optional: set up Ditto Specs

The specs CLI reads a Ditto API token directly, so this part does need one. If you don't have a key handy, create a new one in Developers > API Keys.

Add your API key as a value accessible from the terminal like so:

export DITTO_TOKEN=<your-api-token>

Ditto Specs are *.ditto.md files that co-locate copy rules with your components. Run
/ditto-spec-setup and the agent will install the specs CLI if missing, creates dittospec.config.json and workspace.ditto.md, and scaffolds component spec files.

With specs in place /ditto-spec-audit, /ditto-spec-component, and /ditto-spec-gaps become usable.

Try it on the example

The [example/](example) directory contains sample components seeded with copy problems (inconsistent casing, "Log in" vs "sign in", shouty errors). From this repo:

And /ditto-review does the same for just your working diff, useful right before a commit: