Metadata-Version: 2.4
Name: wizelit-acp
Version: 0.1.3
Summary: Wizelit ACP stdio proxy — connect IDEs to Wizelit over Agent Client Protocol
Project-URL: Homepage, https://github.com/wizeline/wizelit
Project-URL: Documentation, https://github.com/wizeline/wizelit/blob/main/Platform/wizelit-v2/docs/acp-setup.md
Project-URL: Repository, https://github.com/wizeline/wizelit
Project-URL: Issues, https://github.com/wizeline/wizelit/issues
Author-email: Wizeline <engineering@wizeline.com>
License-Expression: MIT
License-File: LICENSE
Keywords: acp,agent-client-protocol,cursor,ide,wizelit,zed
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27.0
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# wizelit-acp

Stdin/stdout bridge between an [ACP](https://agentclientprotocol.com)-compatible editor and the Wizelit `/acp` WebSocket.

Published on **[PyPI](https://pypi.org/project/wizelit-acp/)** — editors spawn it via `uvx` (no separate install step).

## Teammate setup (2 steps)

1. Install [uv](https://docs.astral.sh/uv/): `brew install uv`
2. Add to your editor:

```json
{
  "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](../../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

```bash
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`) |

## Development

From the monorepo root:

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

Release: [docs/acp-release-runbook.md](../../docs/acp-release-runbook.md)
