Terminal (TUI)

The pa terminal application runs Posit Assistant in your terminal — interactive or headless for scripting and automation.

Posit Assistant TUI displaying data and an R plot in the terminal

Quick Install

On macOS or Linux, install with a single command:

curl -fsSL https://posit-dev.github.io/assistant/builds/install-tui.sh | bash

The script detects your OS and architecture, downloads the appropriate binary, and installs it. Customize the install location with the INSTALL_DIR environment variable.

After installation, run:

pa

Manual Downloads

Download the binary for your platform and extract it:

Platform	Architecture	Download
macOS	ARM64 (Apple Silicon)	pa-macos-arm64.gz
Linux	x64	pa-linux-x64.gz
Linux	ARM64	pa-linux-arm64.gz
Windows	x64	pa-windows-x64.zip

On macOS or Linux, install manually with:

gunzip pa-*.gz
chmod +x pa-*
sudo mv pa-* /usr/local/bin/pa

On Windows, extract pa-windows-x64.zip and run executable inside it.

Model Provider

The TUI uses Posit AI as its default provider. Run pa and follow the sign-in prompt to authenticate with your Posit AI account.

To use a different provider, configure it in the config file (~/.positai/settings.json).

Further Configuration

See TUI Usage for interactive mode flags, headless mode, image rendering, and other terminal-specific options.