Coding tools

Use Mirage from
your coding tool.

Ask Claude Code, Codex, Cursor, or another coding tool to change a site. Mirage does the work in a quiet Chrome window. You stay in your editor.

  1. 1

    Turn on coding tools in Mirage

    Open Mirage, go to Settings, and turn on Allow coding tools. You need to be signed in.

    No Mirage yet? Try Beta

  2. 2

    Connect your coding tool

    Pick one. They all do the same thing.

    Easiest: ask your coding tool

    Set up Mirage for me. Run `npx -y @trymirage.app/mcp install` in a terminal, then run `npx -y @trymirage.app/mcp doctor` and tell me what it says. If you can't reload your MCP servers yourself, tell me to restart you so the Mirage tools load, then call mirage_status. If it says Allow coding tools is off, tell me to turn it on in Mirage Settings.

    Or run it yourself

    npx -y @trymirage.app/mcp install

    Works with Claude Code, Codex, Cursor, OpenCode, Hermes, Grok, oh-my-pi, and T3 Code, on Mac and Linux.

  3. 3

    Ask for a change

    Tell your coding tool what you want, and mention Mirage. For example: “Use Mirage to hide Shorts on YouTube.”

Claude Code

› Use Mirage to hide Shorts on YouTube

mirage_open_tab youtube.com

mirage_create_draft hide Shorts

mirage_apply

Done. Shorts are hidden on youtube.com.

The chat is in Mirage → History, tagged Claude Code.

How it works

Your coding tool talks to a small Mirage helper on your computer. The helper talks to Mirage in Chrome.

Mirage opens the site in its own window, muted and in the background, drafts the look, and applies it, the same way the side panel does. Your own tabs are never touched.

One chat, one look

On one site, follow-ups change the same look and add a new version. Ask for a separate look when you want one. A new site starts a new chat.

Chats show up in History with your coding tool's name, and you can keep going from the side panel.

Approvals

Applying follows your setting in Mirage. Auto applies. Manual waits for you.

What it can and cannot see

It can see your tab titles, chat previews, and your list of looks. Asks and drafts use Mirage credits and send the page address, title, a page sketch, and a screenshot when there is one to Mirage's AI.

Your coding tool may send what it reads to its own AI provider. Banking, wallet, checkout, and login pages and incognito tabs stay off-limits.

Privacy

Check that it works

npx -y @trymirage.app/mcp doctor
  • Allow coding tools is on.
  • You are signed in.
  • Chrome is running (the helper can start it).
  • Restart your coding tool after installing.

Turn it off

Turn off Allow coding tools in Mirage Settings. To remove the helper:

npx -y @trymirage.app/mcp uninstall