Skip to content

Terminal

Ryan Stoffel edited this page Oct 29, 2026 · 1 revision

Terminal

parallax runs Parallax in your terminal, laid out like Claude Code, with the same threads, Spaces, and Projects as the app, live in both. It talks to the plxd on the computer it runs on and starts it if it isn't running. /settings signs in to providers and GitHub, adds API keys, and changes this computer's settings, so it works without the app.

Parallax in a terminal

parallax is plxd under another name. Run with no arguments, it opens the terminal UI, the same as plxd tui. With a subcommand it is plxd: parallax service status is plxd service status.

Installing

With the app

The app installs the command at its first launch on Linux and Windows, and keeps it up to date at each launch after. On macOS it asks first, because linking into /usr/local/bin takes your password. Settings > General > Terminal command installs, reinstalls, or removes it on any OS.

OS Command What it runs
macOS /usr/local/bin/parallax A link to the plxd inside the app
Linux ~/.local/bin/parallax A link to a copy of the app's plxd in ~/.local/share/parallax/app, since an AppImage's files go away when it quits
Windows parallax.cmd in %LOCALAPPDATA%\Parallax\bin The app's plxd. The folder is added to your user PATH.

The app leaves alone anything named parallax that it didn't make, and doesn't put the command back after you remove it. The Terminal command row is hidden while the Mac app runs from its disk image. Move the app to /Applications first.

Terminal only

On macOS (Apple silicon) and Linux (x64 and arm64), without the app:

curl -fsSL https://raw.githubusercontent.com/ryan-stoffel/parallax/develop/scripts/install-tui.sh | sh

The script downloads the newest nightly's plxd, checks its SHA-256, checks that it runs, puts it in ~/.parallax-plxd, and links ~/.local/bin/parallax to it. It doesn't edit your shell's config files. If ~/.local/bin isn't on your PATH, run ~/.local/bin/parallax, or add the folder to your PATH.

Starting

parallax

Where you run it decides where new threads work:

  • In a git checkout, new threads work in that checkout in place, as Claude Code does, not in a worktree of their own. The first message adds the repository to plxd if it isn't there yet.
  • Inside a thread's worktree, it opens that thread.
  • Anywhere else, new threads start in Chats, and the screen says why.

--data-dir points it at another data folder.

Slash commands

Type / to list them. ↑↓ choose, Enter runs, Tab completes. A command that picks something, such as /model, opens a list when run alone, or picks by name: /model claude-opus-5-5.

Command What it does
/new Start a new thread here, or in the repo or Space named. Also /clear.
/threads Open the sidebar of threads by repo and Space. Also /resume, or ← on an empty prompt.
/provider Choose who runs it: Claude, Codex, Cursor, and the rest
/model Choose one of the provider's models
/effort Choose how hard it thinks
/mode Choose what it may do without asking. Also Shift+Tab.
/stop Stop the turn under way. Also Esc.
/settings Sign in to providers and GitHub, add API keys, change settings
/login Open settings at the first provider that isn't signed in
/help Show the keys
/quit Leave. Also /exit, Ctrl-C twice, or Ctrl-D.

A /provider, /model, /effort, or /mode change goes with your next message.

Keys

Key What it does
@ Mention a file from the checkout
← on an empty prompt Open the sidebar. n there starts a thread.
Shift+Tab Cycle the mode: accept edits, auto mode, plan mode, ask first, bypass permissions
Esc Interrupt the turn
\ or Alt+Enter New line
↑↓ Prompt history
Click a tool line Open that run of tool calls
Ctrl+O Open or close every run of tool calls
Mouse wheel, PgUp, PgDn Scroll
Shift+drag Select text

Approvals

When an agent asks for approval, the terminal shows Yes, No, and for some requests Yes, and don't ask again this session. Press 1, 2, or 3, or move with ↑↓ and press Enter. Esc answers No.

Settings

/settings opens a screen with these sections:

Section What it does
Providers Enter signs in. A provider whose sign-in runs in the terminal gets the terminal until it finishes. Cursor signs in through the browser. Space turns a provider on or off.
New threads The provider new threads run on
GitHub Install the GitHub CLI and sign in with a device code
API keys Add or remove Anthropic, OpenAI, and Cursor keys
General Resume after a usage limit, Continue threads after restarts, Clean up merged worktrees, Parallax Connect, Remote access over HTTPS, Web client, Parallax Relay, and the device name

Updating

A command the app installed runs the app's plxd, so it updates with the app.

A terminal-only install updates when you run its install command again. A plxd that's already running keeps its version until it restarts, and the script says so.

When the install script stops

Message What to do
<home>/.local/bin/parallax is already there and isn't this installer's. Move it, then run this again. Something else is named parallax, such as the command the app installed. Remove it in Settings > General, or move it.
The download's SHA-256 doesn't match <file>.sha256. Nothing was installed. Run the script again.
The downloaded plxd doesn't run here. Nothing was installed. The downloaded plxd failed its --version check on this computer. File a bug with your OS and architecture.

Clone this wiki locally