Metadata-Version: 2.4
Name: pocage
Version: 0.1.0
Summary: Pocket Agent local daemon for pairing your machine and continuing AI coding sessions from the browser.
Author-email: computbiol <48988788+computbiol@users.noreply.github.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://pocage.toce.ai
Project-URL: Repository, https://github.com/computbiol/pocage
Project-URL: Issues, https://github.com/computbiol/pocage/issues
Keywords: pocage,pocket-agent,agent,daemon,acp,codex
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agent-client-protocol<0.9,>=0.8.1
Requires-Dist: websockets>=13.1
Dynamic: license-file

# Pocket Agent Connector

`connector/pocage` is the publishable Python package for the Pocket Agent local daemon. It pairs with backend, connects over an authenticated WebSocket, talks to an ACP-compatible agent backend, and streams ACP updates back to backend. Today the only supported agent is `codex`.

## Environment

This module is managed as its own `uv` project. Keep its virtual environment isolated from `backend/`.

## Pair and Run

Run from `connector/pocage/`:

```bash
uv sync
uv run pocage pair --agent codex --api-url http://127.0.0.1:8000 --pairing-code <code-from-web>
uv run pocage --agent codex
```

Use the API URL that matches your chosen mode:

- local development with `.env.local`: `http://127.0.0.1:8000`
- Docker Compose with `.env.compose`: `http://127.0.0.1:8080`

The matching templates live at the repository root as `.env.local.example` and `.env.compose.example`.

Before the first run, install the `codex` ACP backend globally so it is available on `PATH`:

```bash
npm install -g @zed-industries/codex-acp
```

## Package Development

- `uv sync` installs `pocage` into this environment as an editable package for local development.
- The `pocage` console script is defined in `pyproject.toml`.
- Use `uv run pocage ...` for day-to-day debugging against local source changes.

## Release Verification

Before publishing to PyPI, verify the non-editable install path:

```bash
./scripts/verify-release-install.sh
```

The script:

- builds both `sdist` and `wheel`
- creates fresh temporary virtual environments
- installs each artifact as a non-editable package
- runs `uv pip check`
- verifies `import pocage` resolves from `site-packages`, not the source tree
- runs `pocage --help` as a console-script smoke test
