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).

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:

pip install agentrix-cli
agentrix pair

Keep the terminal open after pairing — it bridges your local project files to the phone. Press Ctrl+C when you're done.

Optional overrides (local relay, custom host):

Option A — env (PowerShell, local dev):

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

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

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

Option C — flag:

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.