NIZZY
NIZZY

Install

Install NIZZY

Three steps: install the package, register this device, then open NIZZY in the browser. Details for each step are below.

  1. 1

    Install

    Install the Mac or Windows package, then connect it in Cursor (the default). Other IDEs use the same launcher.

  2. 2

    Register device

    Open Apps or run nizzy_license login, then authorize the user code on /device.

  3. 3

    Open NIZZY in the browser

    Go to http://127.0.0.1:3000/apps/ (or the port you set as NIZZY_PORT).

1. Install

Mac

Run this in Terminal. It installs to ~/.nizzy/runtime and opens Cursor with the launcher in that folder.

curl -fsSL https://nizzy.app/install/install-macos.sh | bash

NIZZY Dev (side by side, does not replace Stable):

curl -fsSL https://nizzy.app/install/install-macos-dev.sh | bash
Mac (arm64)Mac (x64)

Already downloaded the archive? Install it without fetching again:

curl -fsSL https://nizzy.app/install/install-macos.sh | NIZZY_TARBALL=/path/to/nizzy-macos-arm64.tar.gz bash

Windows

Download the zip, unzip it to a folder that will stay put, then add that launcher in Cursor (next section) or another IDE.

Windows (x64)
  1. Unzip to %USERPROFILE%\.nizzy\runtime\ so you have nizzy-windows-x64\nizzy.cmd.
  2. Use that .cmd path as the MCP command (there is no .exe).

Cursor

Default host. MCP server nizzy, port 3000. Apps live in ~/.nizzy/apps; the package is ~/.nizzy/runtime.

Cursor is the default. On Mac the one-liner opens the MCP install deeplink for you. If it does not, or you installed on Windows, add server nizzy in Cursor Settings → Customize → MCP. Use an absolute path, not ~. On Windows replace YOU with your username.

Mac

{
  "mcpServers": {
    "nizzy": {
      "command": "~/.nizzy/runtime/nizzy",
      "env": {
        "NIZZY_PORT": "3000"
      }
    }
  }
}

Windows

{
  "mcpServers": {
    "nizzy": {
      "command": "C:\\Users\\YOU\\.nizzy\\runtime\\nizzy-windows-x64\\nizzy.cmd",
      "env": {
        "NIZZY_PORT": "3000"
      }
    }
  }
}

Other IDEs

After the Mac or Windows install, paste a snippet into the host’s MCP settings and set command to the launcher in ~/.nizzy/runtime (Mac) or nizzy.cmd under .nizzy\runtime\ (Windows).

VS Code + Copilot

NIZZY_IDE=vscode

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

{
  "servers": {
    "nizzy": {
      "type": "stdio",
      "command": "~/.nizzy/runtime/nizzy",
      "env": {
        "NIZZY_IDE": "vscode",
        "NIZZY_PORT": "3000"
      }
    }
  }
}

Windsurf

NIZZY_IDE=windsurf

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

{
  "mcpServers": {
    "nizzy": {
      "command": "~/.nizzy/runtime/nizzy",
      "env": {
        "NIZZY_IDE": "windsurf",
        "NIZZY_PORT": "3000"
      }
    }
  }
}

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/runtime/nizzy",
      "env": {
        "NIZZY_IDE": "generic",
        "NIZZY_PORT": "3000"
      }
    }
  }
}

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_PORT=3000 \
  -- ~/.nizzy/runtime/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/runtime/nizzy"

[mcp_servers.nizzy.env]
NIZZY_IDE = "generic"
NIZZY_PORT = "3000"

# CLI equivalent:
# codex mcp add nizzy --env NIZZY_IDE=generic --env NIZZY_PORT=3000 \
#   -- ~/.nizzy/runtime/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/runtime/nizzy",
      "env": {
        "NIZZY_IDE": "generic",
        "NIZZY_PORT": "3000"
      }
    }
  }
}

Zed

NIZZY_IDE=generic

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

{
  "context_servers": {
    "nizzy": {
      "command": "~/.nizzy/runtime/nizzy",
      "env": {
        "NIZZY_IDE": "generic",
        "NIZZY_PORT": "3000"
      }
    }
  }
}

2. Register 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.

3. Open NIZZY in the browser

After the launcher is running (Cursor or another IDE connected), open http://127.0.0.1:3000/apps/. That is the Apps catalog. If you set a different NIZZY_PORT, use that port instead.