QuickstartQuickstart

1. Install

Windows 10 and 11 on Windows x64 or Windows ARM64, in a 64-bit Windows PowerShell 5.1 or PowerShell 7 window:

macOS and Linux

macOS Apple Silicon, macOS Intel, Linux x64 and Linux ARM64, with bash 3.2 or newer, curl or GNU wget, and sha256sum or shasum. Linux binaries are static with no glibc requirement.

The Linux installer verifies SHA-256 against the checksum sidecar.

• Windows installs under %USERPROFILE%\.rightnow\bin by default and prepends it to your user PATH. Open a new terminal when it finishes.
• macOS and Linux install under ~/.rightnow/bin by default. Follow the printed PATH line: open a new terminal or source the file it names.
• Both verify the download against the checksum sidecar, prove --version, and keep the previous binary for rollback.

RIGHTNOW_VERSION pins a published version; RIGHTNOW_CHANNEL selects stable (default) or alpha; RIGHTNOW_BIN_DIR sets the bin directory. RIGHTNOW_HOME sets the product home; keep it set when you launch the CLI. Install covers legacy aliases, PATH recovery, proxies and the expected installer output.

2. Check diagnostics

Open the project root in your terminal, then run:

rightnow --version
rightnow doctor

Doctor checks terminal capabilities, keyboard behavior and clipboard routes. A report can contain issues or recommendations and still exit successfully, so read its findings; Troubleshooting explains how to recover.

3. Launch and connect

Get a RunInfra key at runinfra.ai/settings/api-keys (sign-in required), then start RightNow. The Authentication guide covers other providers, environment variables and stored keys.

PS> rightnowCopy
# Without a provider credential: Connect screen excerpt
Connect a provider

Launching without an effective provider credential opens the Connect screen. Choose a provider and enter its key; RightNow validates it before saving. /connect reopens it in a session. Instead, you can set RIGHTNOW_API_KEY for RunInfra; a nonempty environment credential wins over a stored key. No RightNow account is needed; accounts moved to RunInfra.

The user config is config.toml in the effective product home, normally $HOME\.rightnow\config.toml on Windows or ~/.rightnow/config.toml on macOS and Linux. See Configuration.

Send a first prompt

Type a request in the composer and press Enter. Responses, tool calls and file edits appear in the scrollback. For example:

Summarize this workspace

Prompts and relevant tool results go to the configured provider; local tool access follows your permission mode.

4. Run a headless task

Headless mode sends one prompt, prints the response to stdout, and exits. Assistant wording varies, and no complete replay of this task is recorded: the demo shows only the line printed when executable effects complete. An informational answer omits it.

PS> rightnow -p "Create result.txt with hello"Copy
# Conditional verified-effects output excerpt
Headless completed with verified effects: <effects-summary>

An audited successful turn exits with code 0. Headless mode never asks for approvals on stdin; unresolved approvals fail closed. Use automatic approval flags only when automatic tool approval is acceptable for your workspace and host.

Build from source

The agent source is not published. Enterprise customers can ask us about source access. Authorized repository contributors can use the pinned Rust toolchain on Windows, macOS, or Linux. Run these from the repository root.

cargo build -p rightnow-pager-bin --release

Use the launchers for the TUI and prompts. For subcommands, call rightnow-pager.exe <subcommand> (on macOS and Linux, target/release/rightnow-pager) directly.