Metadata-Version: 2.4
Name: agentrix-cli
Version: 0.2.3
Summary: Agentrix CLI: run coding agents headless, from anywhere.
License: MIT
Requires-Python: >=3.11
Requires-Dist: agentrix-core>=0.2.1
Requires-Dist: qrcode[pil]>=7.4
Requires-Dist: rich>=13.7
Requires-Dist: textual>=0.70
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# agentrix CLI

A terminal frontend to `agentrix-core`. For local agent runs the CLI
embeds the runtime directly. For **phone pairing** it talks to a relay
(local or hosted).

```bash
pip install -e packages/core[all] -e apps/cli

agentrix login              # store BYOK keys in the OS keyring
agentrix run "fix the failing tests in this repo"
agentrix chat               # interactive TUI
agentrix index build        # build the semantic index
agentrix mcp list           # list configured MCP servers
```

## Pairing with the hosted relay

Production installs default to **`https://relay.agentrix.space`**. Run:

```bash
pip install agentrix-cli
agentrix pair
```

Optional overrides (local relay, custom host):

**Option A — env** (PowerShell, local dev):

```powershell
$env:AGENTRIX_RELAY_URL = "http://localhost:8765"
agentrix pair
```

**Option B — user config** (`~/.agentrix/config.toml`):

```toml
[relay]
url = "https://relay.agentrix.space"
# auth_token = "..."   # only if your relay requires AGENTRIX_RELAY_AUTH_TOKEN
```

**Option C — flag**:

```bash
agentrix pair --relay-url https://relay.agentrix.space
```

Resolution order: `--relay-url` → `AGENTRIX_RELAY_URL` → `config.toml` →
`https://relay.agentrix.space`.

Local mode still runs the agent on your laptop; the hosted relay only
bridges your phone ↔ IDE. Use **Cloud mode** in the app if you want the
agent to run on the server instead.
