wizelit-acp 0.1.4

Wizelit ACP stdio proxy — connect IDEs to Wizelit over Agent Client Protocol

wizelit-acp

Stdin/stdout bridge between an ACP-compatible editor and the Wizelit /acp WebSocket.

Published on PyPI — editors spawn it via uvx (no separate install step).

Teammate setup (2 steps)

1. Install uv: brew install uv
2. Add to your editor:

{
  "agent_servers": {
    "wizelit-hub": {
      "type": "custom",
      "command": "uvx",
      "args": ["wizelit-acp@latest"],
      "env": {
        "WIZELIT_API_URL": "https://your-wizelit-hub.example.com"
      }
    }
  }
}

Connect from the editor. On first use, the browser opens for device-link pairing — no terminal auth login required.

Full guide: docs/acp-setup.md

How it works

• uvx fetches this package from PyPI on first run.
• ACP JSON-RPC on stdin/stdout ↔ WebSocket to WIZELIT_API_URL + /acp.
• Credentials: ~/.wizelit/credentials.json (auto-created on pairing).
• Agent execution happens on the Wizelit server, not locally.

Optional CLI

uvx wizelit-acp auth login    # manual pairing
uvx wizelit-acp auth logout   # revoke local credentials

Environment

Variable	Purpose
WIZELIT_API_URL	REST base URL (default http://127.0.0.1:8000)
WIZELIT_ACP_URL	Override WebSocket URL
WIZELIT_AUTO_PAIR	0 to disable auto pairing on Connect
WIZELIT_CLIENT_NAME	Pairing label (default ACP IDE)
WIZELIT_ALLOW_INSECURE	1 to allow plain http:// / ws:// to non-loopback hosts (not recommended)

Development

From the monorepo root:

uv sync --package wizelit-acp --extra dev
uv run --package wizelit-acp pytest packages/acp/tests -v

Release: docs/acp-release-runbook.md