Terminal (TUI)

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

📝 Development builds

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.

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

1. Install pa

Install pa with the install script, or download the binary.

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

  1. Download the file for your platform:

    PlatformArchitectureDownload
    macOSARM64 (Apple Silicon)pa-macos-arm64.gz
    Linuxx64pa-linux-x64.gz
    LinuxARM64pa-linux-arm64.gz
    Windowsx64pa-windows-x64.zip
  2. Extract pa from the file and move it to a directory on your PATH.

    On macOS or Linux, run these commands from the directory that contains the download (usually ~/Downloads). The sudo command asks for your computer password.

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

    On Windows, right-click pa-windows-x64.zip and select Extract All. Then move pa.exe to a directory on your user PATH.

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.

  1. In the TUI, press Ctrl+O to open the Authentication window.
  2. Use the Up and Down arrow keys to select a provider. Then press Enter.
  3. Sign in, or enter the information that the provider asks for, such as an API key.
  4. Press Esc to 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.

â„šī¸ Posit AI Pass Docs

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.