Terminal (TUI)
The pa terminal application runs Posit Assistant in your terminal â interactive or headless for scripting and automation.
These downloads are development builds, rebuilt every time a change is merged. They can include features that are not in a release yet; those features are described in the unreleased docs.
1. Install pa
Install pa with the install script, or download the binary.
Option 1: Install with a Script (Recommended)
The install scripts detect your OS and architecture, download the appropriate binary, and install it. Customize the install location with the INSTALL_DIR environment variable.
On macOS or Linux, run in the terminal:
curl -fsSL https://assistant.posit.co/builds/install-tui.sh | bash
By default, the script installs pa in /usr/local/bin. If the script cannot write to that directory, it asks for your computer password. Enter it to complete installation.
On Windows, run in PowerShell:
irm https://assistant.posit.co/builds/install-tui.ps1 | iex
By default, the Windows installer does not modify PATH; it reports the installed binary location and, if needed, the directory to add to your user PATH.
To add it to your user PATH automatically:
$env:ADD_TO_PATH = "1"; irm https://assistant.posit.co/builds/install-tui.ps1 | iex
Option 2: Download the Binary
-
Download the file for your platform:
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 -
Extract
pafrom the file and move it to a directory on yourPATH.On macOS or Linux, run these commands from the directory that contains the download (usually
~/Downloads). Thesudocommand asks for your computer password.gunzip pa-*.gz chmod +x pa-* sudo mv pa-* /usr/local/bin/paOn Windows, right-click
pa-windows-x64.zipand select Extract All. Then movepa.exeto a directory on your userPATH.
2. Start pa
After the install directory is on your PATH, start the TUI by running:
pa
3. Connect a Model Provider
You need at least one model provider to use Posit Assistant.
- In the TUI, press
Ctrl+Oto open the Authentication window. - Use the Up and Down arrow keys to select a provider. Then press
Enter. - Sign in, or enter the information that the provider asks for, such as an API key.
- Press
Escto close the window.
Posit AI Pass
Posit AI Pass is a managed service from Posit that provides access to frontier LLMs. It is at the top of the provider list.
For information on how to create or manage your account, or for details on available models and usage, see the Posit AI Pass documentation.
To connect Posit AI Pass, select it in the Authentication window and sign in with your Posit account.
Additional Providers
The TUI supports many model providers beyond Posit AI Pass. See the Providers page for the full list and setup instructions.
For Databricks, the TUI supports service-principal OAuth and personal access tokens. Browser OAuth is disabled because a terminal session cannot guarantee that the browser can reach its local callback. See Databricks for setup.
4. Start a Conversation
Type a question into the TUI. Then press Enter.
For example prompts, see Your First Conversation.
Next Steps
- To customize Posit Assistant, see Configuration.
- For interactive mode flags, headless mode, image rendering, and other terminal-specific options, see TUI Usage.
- For common tasks, see Guides.