@agora-build/atem

A terminal that connects people, Agora platform, and AI agents. Manage Agora projects and tokens, route tasks between Astation and AI coding agents, generate diagrams, drive voice-powered coding workflows, and more -- all from a single CLI/TUI.

Install

npm install -g @agora-build/atem

This downloads a prebuilt binary for your platform (linux-x64, linux-arm64, darwin-x64, darwin-arm64).

Commands

atem                                    # Launch TUI
atem repl                               # Interactive REPL with AI command interpretation

Authentication

atem login                              # Pair with Astation, sync credentials (interactive y/n save)
atem login --save-credentials           # Pair and auto-save credentials (skip prompt)
atem logout                             # Clear saved session

Tokens

atem token rtc create                   # Generate RTC token (interactive)
atem token rtc create --channel test --uid 0 --expire 3600
atem token rtc decode <token>           # Decode existing RTC token
atem token rtm create                   # Generate RTM token
atem token rtm create --user-id bob --expire 3600

Projects

atem list project                       # List Agora projects
atem list project --show-certificates   # List with app certificates visible
atem project use <APP_ID>               # Set active project by App ID
atem project use <N>                    # Set active project by index (1-based)
atem project show                       # Show current active project

Configuration

atem config show                        # Show resolved config (secrets masked)
atem config set astation_ws <URL>       # Set Astation WebSocket URL
atem config set astation_relay_url <URL> # Set Astation relay URL
atem config clear                       # Clear active project

AI Agents

atem agent list                         # Scan and list detected AI agents
atem agent launch                       # Launch Claude Code as PTY agent
atem agent launch codex                 # Launch Codex as PTY agent
atem agent connect <WS_URL>             # Connect to ACP agent and show info
atem agent prompt <WS_URL> "text"       # Send prompt to ACP agent
atem agent probe <WS_URL>               # Probe URL for ACP support
atem agent visualize "topic"            # Generate visual HTML diagram via ACP agent
atem agent visualize "topic" --url ws://localhost:8765  # Explicit agent URL
atem agent visualize "topic" --no-browser               # Skip opening browser

Dev Servers

atem serv rtc                           # Launch browser-based RTC test page (HTTPS)
atem serv rtc --channel test --port 8443
atem serv rtc --background              # Run as background daemon
atem serv diagrams                      # Host diagrams from SQLite (HTTP)
atem serv diagrams --port 9000          # Custom port (default: 8787)
atem serv diagrams --background         # Run as background daemon
atem serv list                          # List running background servers
atem serv kill <ID>                     # Kill a background server
atem serv killall                       # Kill all background servers

TUI Modes

| Mode | Description | |------|-------------| | Main Menu | Navigate between features | | Claude Chat | Claude Code CLI integration via PTY | | Codex Chat | Codex terminal integration via PTY | | Token Gen | Generate Agora RTC/RTM tokens locally | | Projects | Browse Agora projects via API |

Credential Management

Credentials are encrypted at rest using AES-256-GCM with a machine-bound key.

Priority: Astation sync (live) > env vars > encrypted store
Storage:  ~/.config/atem/credentials.enc

Via Astation (recommended)

atem login          # Pair with Astation, credentials sync automatically

Via environment variables

export AGORA_CUSTOMER_ID="..."
export AGORA_CUSTOMER_SECRET="..."

Astation Pairing

Atem registers with the Station relay service on startup and prints a pairing code:

Pairing code: ABCD-EFGH
Open: https://station.agora.build/pair?code=ABCD-EFGH

Enter the code in Astation's Dev Console to pair. If a local Astation is running on ws://127.0.0.1:8080/ws, Atem connects directly instead.

Supported Platforms

| Platform | Architecture | |----------|-------------| | Linux | x64, arm64 | | macOS | x64, arm64 |

Build from Source

git clone https://github.com/Agora-Build/Atem.git
cd Atem
cargo build --release
# Binary at target/release/atem

Related Projects

• Astation -- macOS menubar hub that coordinates Chisel, Atem, and AI agents — talk to your coding agent from anywhere
• Chisel -- Dev panel for visual annotation and UI editing by anyone, including AI agents
• Vox -- AI latency evaluation platform

License

MIT