Just launched: the Novamira Discord. Be one of the first to join. Join Discord →

Novamira CLI

The Novamira CLI is a command-line way to connect a coding agent to your WordPress site. It is made for agents that work in the terminal, like Claude Code, Codex CLI, Gemini CLI, and similar tools. The MCP connection remains the default and is still the way for chat-only clients; the CLI is a separate, leaner path for terminal agents. Same Novamira underneath.

CLI or MCP

Both connect to the same Novamira on your site, and both authorize the same way, with an OAuth sign-in in your browser. The difference is how your agent reaches the site.

The capabilities are identical either way. CLI or MCP, your agent reaches the same Novamira abilities on the site, with the same access. Only the way in changes, not what it can do once connected.

  • Use the CLI when your agent can run shell commands. It guides the connection, can troubleshoot itself, and keeps only the output that matters.
  • Use MCP when your client only speaks MCP, like Claude Desktop’s Chat tab. See Connecting Your AI Client.

Install

Install the CLI once. It then works across all your sites.

On macOS or Linux, run this in your terminal:

curl -fsSL https://raw.githubusercontent.com/use-novamira/novamira-cli/main/install.sh | sh

On Windows, run this in PowerShell:

irm https://raw.githubusercontent.com/use-novamira/novamira-cli/main/install.ps1 | iex

Run it once and it asks which agent you use, then wires itself up for that one.

Use it

You do not run CLI commands yourself. After installing, you just tell your agent, in plain words, to use Novamira. For example: Use Novamira to build a landing page on my staging site. From there the agent takes over: it starts the browser sign-in for you to approve, checks the site, discovers what it can do, and works, following a built-in safe-path guide.

If you also have a Novamira MCP server configured in the same agent, say “Novamira CLI” instead of just “Novamira”, so the agent picks the right one and there is no name clash.

Access you approve

When you connect a site, you authorize the access in your browser, so you stay in control. The CLI requests full access, so the agent can read your site and make changes.

It troubleshoots itself

If the connection has a problem, the agent does not go silent. It runs its own checks, reads the real errors, and works out a fix, with a built-in self-check. You do not need to diagnose anything by hand.

Supported agents

Any agent that can run shell commands works with the Novamira CLI. This includes AdaL, AiderDesk, Amp, Antigravity, Antigravity CLI, AstrBot, Augment, Autohand Code CLI, Claude Code, Cline, CodeArts Agent, CodeBuddy, Codemaker, Codex, Code Studio, Command Code, Continue, Cortex Code, Crush, Cursor, Deep Agents, Devin for Terminal, Dexto, Droid, Eve, Firebender, ForgeCode, Gemini CLI, GitHub Copilot, Goose, Hermes Agent, IBM Bob, iFlow CLI, inference.sh, Jazz, Junie, Kilo Code, Kimi Code CLI, Kiro CLI, Kode, Lingma, Loaf, MCPJam, Mistral Vibe, Moxby, Mux, Neovate, Ona, OpenClaw, OpenCode, OpenHands, Pi, Pochi, PromptScript, Qoder, Qoder CN, Qwen Code, Reasonix, Replit, Roo Code, Rovo Dev, Tabnine CLI, Terramind, Tinycloud, Trae, Trae CN, Warp, Windsurf, ZCode, Zed, Zencoder, Zenflow, and any other agent that can run a terminal command.

Requirements

Node.js 22 or newer on your computer, and the Novamira plugin on the site you connect to: WordPress 6.9 or newer with Novamira 1.11.0 or newer. The Novamira CLI is free and open source.