Neonia CLI

Zero-dependency CLI that connects your AI coding tools to Neonia MCP Server: The Cloud Backend for AI Agents.

❌ Without Neonia

• ❌ Every AI tool needs to be manually configured separately
• ❌ MCP server URLs must be copy-pasted into each editor's JSON config by hand
• ❌ Switching between Cursor, VS Code, Windsurf, or Roo Code means starting over

✅ With Neonia

Run one command:

npx neonia

Neonia will:

1. Auto-detect every AI IDE installed on your machine
2. Inject the correct MCP server configuration — including backups of your existing config
3. Provide instant access to Neonia Cloud Memory across all your agents

Supported Editors

| Editor / Extension | Detection | Config Path | |---|---|---| | Cursor | ✅ | ~/.config/Cursor/... | | VS Code + Cline | ✅ | ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/... | | VS Code Insiders + Cline | ✅ | ~/.config/Code - Insiders/... | | VSCodium + Cline | ✅ | ~/.config/VSCodium/... | | VS Code + Roo Code | ✅ | ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/... | | VS Code Insiders + Roo Code | ✅ | ~/.config/Code - Insiders/... | | VSCodium + Roo Code | ✅ | ~/.config/VSCodium/... | | Windsurf | ✅ | ~/.codeium/windsurf/mcp_config.json | | Claude Code | ✅ | ~/.claude.json | | Antigravity IDE | ✅ | ~/.config/Antigravity/... |

All paths are resolved per-platform across macOS, Linux, and Windows.

Installation

Requires Node.js 18 or newer. No global install needed.

npx neonia

[!IMPORTANT] API Key Required: Get a free API key at neonia.io/dashboard to authenticate MCP connections.

Or install globally:

npm install -g neonia
neonia

Usage

Interactive Mode

npx neonia

The wizard will:

• Prompt for your API key once — then save it to ~/.neonia/config.json for all future runs
• Detect all compatible AI IDEs and configure their MCP servers

Dry Run

Preview what would happen without writing anything to disk or the network:

npx neonia --dry-run

Target a Different Environment

# Development (localhost:3010)
npx neonia --env dev

# Staging
npx neonia --env staging

# Custom API endpoint
npx neonia --api-url https://your-instance.example.com/mcp

All Options

Usage:
  npx neonia [options]

Options:
  -d, --dry-run         Run without modifying any files or sending network requests.
  --api-url <url>       Override the default Neonia MCP URL.
  --env <env>           Target environment: dev, staging, or prod (default).
  --reset               Clear saved API key and IDE state — runs the full wizard again.
  -h, --help            Show this help message.

Environment Variables

| Variable | Description | |---|---| | NEONIA_TOKEN | Your Neonia API key (skips the interactive prompt) |

How It Works

1. Configure — reads and patches each detected IDE's config JSON, injecting the neonia MCP server entry with Authorization: Bearer headers
2. Backup — before writing, creates a timestamped .bak_YYYYMMDD_HHMMSS backup of any existing config
3. Persist — saves your API key and IDE setup state to ~/.neonia/config.json — subsequent runs skip asking for the key and re-configuring IDEs automatically

[!NOTE] Run npx neonia --reset to clear saved credentials and re-run the full setup wizard.

Development

# Clone the repo
git clone https://github.com/neonia-io/neonia-cli
cd neonia-cli

# Run tests (Node.js native test runner, no dependencies)
npm test

# Try it locally
node bin/index.js --dry-run

🤝 Connect

• 🌐 neonia.io
• 📚 Global llms.txt Index
• 📢 Follow us on YouTube

📄 License

MIT