zephex
DocsDashboardSign in

One command. No copy-paste.

Install Zephex in 30 seconds

A single command opens your browser, signs you in, creates an API key, and writes the config file for the editor you choose.

$ npx zephex setup

Requires Node.js 18+ — works on macOS, Linux, and Windows.

~/your-project — npx zephex setup

$ npx zephex setup

┌ zephex setup

│

◇ Which editor do you want to connect?

│ ● Cursor — AI-first code editor

│

◇ Install for which scope?

│ ● Global (~/.cursor/mcp.json)

│

│ ⊙ Sign in

│ └ Opening zephex.dev in your browser…

│

◆ Signed in as you@example.com

◆ API key created: zephex-cli-3d816b

◆ Config written to ~/.cursor/mcp.json

│

└ You're connected. Open a new chat in Cursor to start using Zephex.

Two ways to connect

The wizard asks how you want your AI agent to access Zephex. Pick one — or skip the prompt with a flag.

Mode 1

MCP server

The wizard signs you in, creates an API key, and writes the right MCP config file for your editor. Best for Cursor, Claude Code, VS Code, OpenCode, Codex, Gemini CLI, Antigravity, and TRAE.

$ npx zephex setup --mcp --cursor

Mode 2

CLI + Skills

Drops a single zephex.md skill file that tells your AI agent to use Zephex tools when they fit the task. No browser auth, no API key, no editor config.

$ npx zephex setup --cli --universal
1

Run the command

npx zephex setup — pick your editor from the menu, or skip the menu by passing a flag.

2

Sign in once

Your browser opens to zephex.dev. Sign in to your account — the CLI creates a key for you.

3

Restart editor

The wizard writes the right config file in the right place. Restart your editor and Zephex tools are available.

Editor shortcuts

Skip the editor-selection menu by passing a flag.

Cursor

AI-first code editor

npx zephex setup --cursor

Claude Code

Anthropic's coding agent

npx zephex setup --claude

VS Code

Microsoft's editor

npx zephex setup --vscode

OpenCode

Open-source AI coding agent

npx zephex setup --opencode

Codex

OpenAI's coding agent

npx zephex setup --codex

Gemini CLI

Google's coding agent

npx zephex setup --gemini

Antigravity

Google's agent-first IDE

npx zephex setup --antigravity

TRAE

ByteDance's adaptive AI IDE

npx zephex setup --trae

Other commands

Verify connection

Confirm that an editor is configured correctly and the key works against the live endpoint.

$ npx zephex status

Install AI agent skill

Drop an AGENTS.md skill file into your project so Cursor/Claude/Codex use Zephex tools proactively.

$ npx zephex skills

Project-scoped install

Write the config into the current project instead of your home directory.

$ npx zephex setup --cursor --project

What gets written?

The wizard deep-merges only the zephex entry — every other MCP server in your config is preserved.

{
  "mcpServers": {
    "zephex": {
      "url": "https://zephex.dev/mcp",
      "headers": {
        "Authorization": "Bearer mcp_prod_xxxxxxxxxxxx.xxxxxxxx..."
      }
    }
  }
}

Working over SSH or in CI?

The wizard detects headless sessions and prints manual setup steps instead of trying to open a browser. Visit /dashboard/api-keys to create a key, then paste the config block from there into your editor.

Ready to connect?

$ npx zephex setup
Read the docs•Open dashboard•GitHub