Install

Install NIZZY

Packaged runtime — no Node or npm. Cursor is the fastest path (Mac one-liner opens it for you). The same binary also runs in VS Code, Windsurf, Claude Desktop, Claude Code, Codex, Antigravity, and Zed. Stable and Dev can both be installed — they do not overwrite each other.

1. Stable

Supported release. MCP server nizzy, port 3000, workspace .nizzy/.

Mac — packaged install

Downloads the runtime tarball, installs to ~/.nizzy/bin/nizzy, then opens Cursor with that absolute path. No Node or npm.

NIZZY_DOWNLOAD_BASE_URL=https://downloads.nizzy.app/prod \
NIZZY_CONTROL_PLANE_URL=https://nizzy-control-plane.onrender.com \
  bash -c "$(curl -fsSL https://nizzy.app/install-macos.sh)"

The installer script is on this site (/install-macos.sh). The .tar.gz comes from https://downloads.nizzy.app/prod. If the deeplink does not open, paste the JSON into Cursor Settings → MCP (use the absolute path, not ~).

Direct download

Mac (arm64)Mac (x64)Windows (x64)

Windows: unzip and set Cursor MCP command to the absolute path of nizzy.cmd (Dev: nizzy-dev.cmd). Or run the Mac installer with a local NIZZY_TARBALL=….

Also install Dev

Bleeding-edge builds of the same product. MCP server nizzy-dev, port 3100, workspace .nizzy-dev/. Adds a second Cursor MCP entry — it does not replace Stable.

Mac — packaged install

Downloads the runtime tarball, installs to ~/.nizzy-dev/bin/nizzy-dev, then opens Cursor with that absolute path. No Node or npm.

NIZZY_CHANNEL=dev \
NIZZY_DOWNLOAD_BASE_URL=https://downloads.nizzy.app/prod \
NIZZY_CONTROL_PLANE_URL=https://nizzy-control-plane.onrender.com \
  bash -c "$(curl -fsSL https://nizzy.app/install-macos.sh)"

Direct download

Mac (arm64)Mac (x64)Windows (x64)

Windows: unzip and set Cursor MCP command to the absolute path of nizzy.cmd (Dev: nizzy-dev.cmd). Or run the Mac installer with a local NIZZY_TARBALL=….

Other IDEs

Same launcher. Paste the snippet into the host’s MCP settings and set command to the absolute path of nizzy (Mac) or nizzy.cmd (Windows).

VS Code + Copilot

NIZZY_IDE=vscode

Project file .vscode/mcp.json (servers key, not mcpServers).

{
  "servers": {
    "nizzy": {
      "type": "stdio",
      "command": "~/.nizzy/bin/nizzy",
      "args": [],
      "env": {
        "NIZZY_IDE": "vscode",
        "NIZZY_LICENSE_ENFORCEMENT": "true",
        "NIZZY_CONTROL_PLANE_URL": "https://nizzy-control-plane.onrender.com",
        "NIZZY_REPORT_SERVER_ENABLED": "true"
      }
    }
  }
}

Windsurf

NIZZY_IDE=windsurf

User file ~/.codeium/windsurf/mcp_config.json (Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json).

{
  "mcpServers": {
    "nizzy": {
      "command": "~/.nizzy/bin/nizzy",
      "args": [],
      "env": {
        "NIZZY_IDE": "windsurf",
        "NIZZY_LICENSE_ENFORCEMENT": "true",
        "NIZZY_CONTROL_PLANE_URL": "https://nizzy-control-plane.onrender.com",
        "NIZZY_REPORT_SERVER_ENABLED": "true"
      }
    }
  }
}

Claude Desktop

NIZZY_IDE=generic

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "nizzy": {
      "command": "~/.nizzy/bin/nizzy",
      "args": [],
      "env": {
        "NIZZY_IDE": "generic",
        "NIZZY_LICENSE_ENFORCEMENT": "true",
        "NIZZY_CONTROL_PLANE_URL": "https://nizzy-control-plane.onrender.com",
        "NIZZY_REPORT_SERVER_ENABLED": "true"
      }
    }
  }
}

Claude Code

NIZZY_IDE=generic

CLI. Replace the command path after install. Restart the session after adding.

claude mcp add nizzy --env NIZZY_IDE=generic \
  --env NIZZY_LICENSE_ENFORCEMENT=true \
  --env NIZZY_CONTROL_PLANE_URL=https://nizzy-control-plane.onrender.com \
  --env NIZZY_REPORT_SERVER_ENABLED=true \
  -- ~/.nizzy/bin/nizzy

OpenAI Codex

NIZZY_IDE=generic

ChatGPT desktop, Codex CLI, and the Codex IDE extension share ~/.codex/config.toml (project: .codex/config.toml). TOML, not JSON. Or: Settings → MCP servers.

[mcp_servers.nizzy]
command = "~/.nizzy/bin/nizzy"

[mcp_servers.nizzy.env]
NIZZY_IDE = "generic"
NIZZY_LICENSE_ENFORCEMENT = "true"
NIZZY_CONTROL_PLANE_URL = "https://nizzy-control-plane.onrender.com"
NIZZY_REPORT_SERVER_ENABLED = "true"

# CLI equivalent:
# codex mcp add nizzy --env NIZZY_IDE=generic --env NIZZY_LICENSE_ENFORCEMENT=true \
#   --env NIZZY_CONTROL_PLANE_URL=https://nizzy-control-plane.onrender.com \
#   --env NIZZY_REPORT_SERVER_ENABLED=true -- ~/.nizzy/bin/nizzy

Google Antigravity

NIZZY_IDE=generic

Antigravity IDE, CLI, and 2.0 share ~/.gemini/config/mcp_config.json (workspace: .agents/mcp_config.json). Or: agent panel → MCP Servers → View raw config. Gemini CLI uses the same global file.

{
  "mcpServers": {
    "nizzy": {
      "command": "~/.nizzy/bin/nizzy",
      "args": [],
      "env": {
        "NIZZY_IDE": "generic",
        "NIZZY_LICENSE_ENFORCEMENT": "true",
        "NIZZY_CONTROL_PLANE_URL": "https://nizzy-control-plane.onrender.com",
        "NIZZY_REPORT_SERVER_ENABLED": "true"
      }
    }
  }
}

Zed

NIZZY_IDE=generic

settings.json → context_servers (not mcpServers). macOS/Linux: ~/.config/zed/settings.json.

{
  "context_servers": {
    "nizzy": {
      "command": "~/.nizzy/bin/nizzy",
      "args": [],
      "env": {
        "NIZZY_IDE": "generic",
        "NIZZY_LICENSE_ENFORCEMENT": "true",
        "NIZZY_CONTROL_PLANE_URL": "https://nizzy-control-plane.onrender.com",
        "NIZZY_REPORT_SERVER_ENABLED": "true"
      }
    }
  }
}

2. Pair the device

Open Apps or run nizzy_license login.
Authorize the user code on /device.
Workspace catalog syncs on the next daemon start.