NIZZY
NIZZY

Install

Install NIZZY for Cursor

One-click MCP install via Cursor deeplink, or a Mac binary that lands at a stable path (~/.nizzy/bin/nizzy). Stable and Dev can both be installed — they do not overwrite each other.

1. Stable

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

Fastest — npx (requires Node)

Deeplink adds a Cursor MCP server named nizzy (npx -y nizzy@latest). Installing Dev does not replace Stable. If the browser blocks cursor://, paste the JSON into Cursor Settings → MCP.

{
  "mcpServers": {
    "nizzy": {
      "command": "npx",
      "args": [
        "-y",
        "nizzy@latest"
      ],
      "env": {
        "NIZZY_CHANNEL": "stable",
        "NIZZY_PORT": "3000",
        "NIZZY_REPORT_PORT": "4321",
        "NIZZY_REPORT_SERVER_ENABLED": "true",
        "NIZZY_CONTROL_PLANE_URL": "http://127.0.0.1:8787",
        "NIZZY_LICENSE_ENFORCEMENT": "true"
      }
    }
  }
}

No Node — Mac binary

Downloads the packaged runtime, installs to ~/.nizzy/bin/nizzy, then opens the Cursor MCP deeplink with that absolute path.

# Set NEXT_PUBLIC_DOWNLOAD_BASE_URL, then:
NIZZY_DOWNLOAD_BASE_URL=https://cdn.example.com/nizzy \
NIZZY_CONTROL_PLANE_URL=http://127.0.0.1:8787 \
  bash -c "$(curl -fsSL https://YOUR_SITE/install-macos.sh)"

After install, MCP command must be the absolute path (the shell script expands ~). Pair the device on /device.

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.

Fastest — npx (requires Node)

Deeplink adds a Cursor MCP server named nizzy-dev (npx -y -p nizzy nizzy-dev). Installing Dev does not replace Stable. If the browser blocks cursor://, paste the JSON into Cursor Settings → MCP.

{
  "mcpServers": {
    "nizzy-dev": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "nizzy",
        "nizzy-dev"
      ],
      "env": {
        "NIZZY_CHANNEL": "dev",
        "NIZZY_PORT": "3100",
        "NIZZY_REPORT_PORT": "4322",
        "NIZZY_REPORT_SERVER_ENABLED": "true",
        "NIZZY_CONTROL_PLANE_URL": "http://127.0.0.1:8787",
        "NIZZY_LICENSE_ENFORCEMENT": "true"
      }
    }
  }
}

No Node — Mac binary

Downloads the packaged runtime, installs to ~/.nizzy-dev/bin/nizzy-dev, then opens the Cursor MCP deeplink with that absolute path.

# Set NEXT_PUBLIC_DOWNLOAD_BASE_URL, then:
NIZZY_CHANNEL=dev \
NIZZY_DOWNLOAD_BASE_URL=https://cdn.example.com/nizzy \
NIZZY_CONTROL_PLANE_URL=http://127.0.0.1:8787 \
  bash -c "$(curl -fsSL https://YOUR_SITE/install-macos.sh)"

After install, MCP command must be the absolute path (the shell script expands ~). Pair the device on /device.

2. Optional: direct package download (Stable)

Prefer unpacking yourself? Grab the tarball, then run the installer with NIZZY_TARBALL=…, or point MCP at the launcher inside the archive.

Set NEXT_PUBLIC_DOWNLOAD_BASE_URL to enable download buttons (CDN hosting dist/*.tar.gz). Also host install-macos.sh there, or use the copy on this site at /install-macos.sh.

3. Pair the device

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