Watch on Instagram What it does
Novamira is a free, open-source WordPress plugin. It’s a bridge between your AI tool and your website.
- Without it: you copy code from ChatGPT, paste it into WordPress, see an error, go back, and repeat.
- With it: the AI works on the site itself. It can read your settings, edit pages, write and test code and check the database, all inside one chat. You approve each step.
It works with Claude (Code, desktop app and Claude.ai), ChatGPT, Codex, Cursor, Gemini CLI and more.
Novamira gives the AI full control of the site. Novamira’s own docs say: use it on a staging site (a private test copy), not your live site, and always keep a backup. It doesn’t make backups and can’t undo changes.
Before you start
- WordPress 6.9 or newer (Dashboard → Updates) and PHP 8.0 or newer (Tools → Site Health → Info → Server).
- HTTPS: your site address starts with
https://. - An Administrator login for the site.
- An AI tool: Claude Code, the Claude app, Claude.ai or ChatGPT.
- Node.js 22 or newer, only if you use Claude Code, Codex or Cursor. Get the LTS version from nodejs.org.
- A backup of the site, and ideally a staging copy. Most hosts offer one-click staging.
Setup in 6 steps
Find Novamira
Google “novamira” and open the official site, novamira.ai. It isn’t in the WordPress.org plugin directory, so get it from their site or their GitHub only.
Download the zip
Click Download for Free → Download zip. Keep it as a
.zipfile. Don’t unzip it.Upload it to WordPress
In WordPress, go to Plugins → Add New Plugin → Upload Plugin. Drag and drop the zip (or click Choose File), then Install Now and Activate Plugin. A new Novamira menu appears in the sidebar. It does nothing until the next step.
Turn on AI Abilities
Open Novamira → Configuration and tick Enable AI Abilities. A red Novamira ON label shows in the top bar. Untick the box any time to cut off every AI connection at once.
Choose your AI tool
On the same page, under Choose your AI tool, click the one you use: Claude Code, Claude app, Claude.ai or ChatGPT. The page then shows only the methods that work for that tool, with your site address already filled in.
Connect and paste the prompt
For Claude Code, pick Novamira CLI (the recommended option). Click Copy prompt, paste it into Claude Code and send it. Claude sets up the connection and asks you to approve access in your browser.
Test itClose and reopen your AI tool, start a new chat and ask: “List the plugins installed on this WordPress site.” If you get the right list, it’s working.
Prompts that work
Start with questions that only read the site:
Which theme and page builder does this site use?
List all pages that have no meta description.
Why is my homepage slow? Just explain, don't fix.
Then, on staging, let it change things:
Write a meta description for each page that has none. Show me the plan first. Don't change anything yet.
Find every page with the old phone number and replace it with the new one. Show me the list first.
6 rules to follow every time
- Backup first. Take one before every session.
- Staging, not live. Check the changes, then push them to the live site.
- Plan before action. Start with “Show me the plan first. Don’t change anything yet.”
- Read before you approve. Keep your AI tool’s “ask before running” setting on.
- Use a strong model for hard tasks.
- One chat per task. Long chats get confused.
Common errors
First open Novamira → Troubleshoot. It checks the connection and tells you what’s wrong.
"Connection refused"
AI Abilities are switched off. Tick Enable AI Abilities again (step 4)."npx: command not found"
Node.js isn’t installed. Install the LTS version from nodejs.org, then reopen your terminal and AI tool.Connected, but no Novamira tools show up
Fully close and reopen the AI tool, then start a new chat.Claude.ai or ChatGPT can't connect
Your host or firewall may be blocking AI traffic. Use the Application Password option on the Configuration page instead."Authentication failed" / 401
The username or app password is wrong, often because of a stray space. Make a new Application Password and paste it again.Site breaks after an AI change
Novamira pauses broken AI-written code automatically (Safe mode). Go to Novamira → Sandbox, have the AI fix it, then click Exit Safe Mode. For anything else, restore your backup.How to switch it off
- Stop all AI access now: untick Enable AI Abilities. Your site keeps working.
- Remove one connected tool: Novamira → Manage Connections → revoke it.
- Remove Novamira: deactivate and delete it in Plugins. Changes the AI already made stay.