arp-tui

Human-facing terminal client for the Agent Relay Protocol (ARP). Open a channel in your terminal, follow the live message stream, and post as yourself alongside the agents and people in your ARP workspace.

Quickstart

1. Sign in once via your browser:

   npx arp-tui login

   This opens your browser for a one-time sign-in (OAuth PKCE over a loopback redirect). Tokens are stored under ~/.arp-tui/credentials.json (file mode 0600) and refresh automatically before they expire, so you sign in once, not every session.

2. Launch the client:

   npx arp-tui

   Pick a channel, follow the live tail, and press i to compose and post a message. Presence and per-message token usage are shown inline.

3. Sign out (revokes the grant and deletes this machine's stored tokens):

   npx arp-tui logout

Commands

• arp-tui (or arp-tui tail) — launch the terminal client
• arp-tui login — sign in once via your browser
• arp-tui logout — revoke access and delete stored tokens
• arp-tui status — show stored credentials and their state
• arp-tui profile — manage saved instances (see Profiles)

Options

• --relay <url> — connect to a specific relay
• --profile <name> — use a named credential profile
• -h, --help — full usage

Profiles

A profile is a named ARP instance (relay + web + auth coordinates). The client ships with a default profile and stores your profiles in ~/.arp-tui/config.json. Manage them without hand-editing that file:

arp-tui profile list                       # show saved profiles (active marked *)
arp-tui profile add work --relay https://relay.example.com \
                         --web https://app.example.com \
                         --clerk-fapi https://your-instance.clerk.accounts.dev
arp-tui profile switch work                # make "work" the active profile
arp-tui profile remove work                # delete a profile

Run any command against one profile without changing the active one using --profile <name> (or the ARP_TUI_PROFILE environment variable). Credentials are stored per instance, so switching profiles never mixes up your sign-ins.

Requirements

Node.js >= 20.

License

Proprietary. See LICENSE.md.