← back to terminal

TX Agent

Install the TX Agent — Terminal X as a command-line tool that lives in your shell. Same multi-AI routing, same credits, same connectors, plus tools to read/write files and run commands on your machine. Works on macOS, Linux, and Windows.

Install in 3 commands
  1. 01Install
    npm install -g @terminalxapp/cli

    Requires Node.js 22+. If you don't have it, install from nodejs.org first. On macOS you can also run `brew install node`. If you use nvm: `nvm install 22 && nvm use 22`.

  2. 02Sign in
    tx login

    Opens your browser to authenticate against your terminalxapp.com account. Your credits, sessions, and connectors all sync — there's no separate CLI account.

  3. 03Use it
    tx

    Starts an interactive session. Or fire one-shot prompts: `tx "refactor this file to TypeScript"`. The CLI gets the same models, same parser, and same connectors as the web app.

Platforms
macOS
Bash, Zsh, Fish. iTerm2 & Terminal.app both fine.
Linux
Tested on Ubuntu, Debian, Arch, Fedora.
Windows
PowerShell, Windows Terminal, WSL2 — all supported.
Quick reference
txInteractive session in the current directory
tx "<prompt>"One-shot prompt, prints result and exits
tx balanceCredits remaining
tx logoutClear local credentials
tx --helpFull command list
FAQ
What does the CLI do that the web app doesn't?▾

It can read/write files in your current directory, run shell commands you approve, and chain that with the multi-AI router. Web app is best for building artifacts; CLI is best for working inside an existing project.

What makes TX Agent different from other coding agents?▾

Three things. (1) Plan mode — for multi-step work the agent drafts a numbered checklist and ticks off steps in real time so you can redirect early. (2) Sub-agents — for parallel research the agent spawns focused workers that run simultaneously (e.g. 'compare 4 libraries' fans out into 4 parallel investigators). (3) Consult panel — one tool call routes your question to Claude, GPT, and Gemini in parallel and synthesizes a recommendation. No other CLI does this.

Do my credits transfer?▾

Yes — the CLI uses the same balance as the web app. Run `tx balance` any time to check.

Which models work?▾

Every model wired in the web app — Claude, GPT-5, Gemini, Grok, Llama, Qwen, plus image (Flux, Recraft, Ideogram, Nano Banana), audio (ElevenLabs), video (Runway, Pika), and all 30+ connectors.

Where's my data?▾

Auth token in ~/.terminal-x/credentials. Sessions sync to your Supabase like the web app. Nothing in your project directory leaves your machine unless a tool you ran explicitly asked for it.

Hitting an issue? Run tx --debug and email the output to support@terminalxapp.com.