RightNow Agent opens its interactive terminal UI when you launch it without a headless prompt or subcommand. Model inference goes to your configured OpenAI-compatible provider, while approved tools run on your machine.
Set RIGHTNOW_API_KEY, then run the PowerShell launcher. It starts rightnow-pager.exe and reads ~/.rightnow/config.toml.
$env:RIGHTNOW_API_KEY = "<your key>"
.\rightnow.ps1Running the binary without -p, --prompt-json, --prompt-file, or a subcommand opens the TUI. Windows is the measured product path; macOS and Linux support is not verified for this release.
Type a request in the composer and press Enter. The scrollback streams responses, tool calls, command output, and file edits. Press Tab to move between the composer and scrollback.
Explain the authentication flow and identify its tests.Typing @ opens a fuzzy file picker. It respects .gitignore and hides dotfiles by default. Add a line range for precise context, or use @! to include hidden files.
@src/main.rs
@src/main.rs:10-50
@src/
@!.envType ! on an empty composer to enter shell mode. The command output is added to the scrollback, where RightNow can use it as context.
Press Ctrl+P or ? to open the searchable command palette. It contains actions, slash commands, keyboard shortcuts, and available skills. Typing / in the composer opens the slash-command menu directly.
| Mode | How to enter | Behavior |
|---|---|---|
| Fullscreen | /fullscreen or --fullscreen | Standard full-screen TUI with the dashboard, theme picker, timeline, and scrollback search. |
| Minimal | /minimal or --minimal | Experimental scrollback-native mode using the terminal palette. It exposes minimal-only actions such as /expand. |
A slash-command switch reopens the same conversation in the other mode for the current session. Set the default screen mode in /settings or under [ui] in the config file.
You can keep typing while a turn runs. With the default queue behavior, pressing Enter adds the message for the next turn. Press Enter again on an empty composer to send the first queued item now. Open the queue pane with Ctrl+;, with Ctrl+' available as a Windows alternative.
If [ui].follow_up_behavior is set to steer, queued text is injected at the next safe model or tool boundary. The send-now chord cancels the foreground turn and starts your message next. Outside VS Code-family terminals, Ctrl+I is the stable Windows alternative when Ctrl+Enter is not delivered correctly; VS Code-family terminals use Ctrl+L.
Questions, permission requests, and the cancel-turn panel temporarily own the keyboard. Tab and Shift+Tab move through the current card, while Enter confirms the focused choice.
| Card | Escape behavior |
|---|---|
| Question | Clears a selection first, then parks focus in scrollback. Press Tab to return. |
| Permission | Parks focus in scrollback without approving or denying the request. |
| Cancel turn | Chooses keep running and closes the panel. |
rightnow-night is the shipped default. In fullscreen mode, use /theme or its /t alias to preview and select the other bundled themes. Minimal mode ignores theme settings and uses the terminal's own palette.
Provider inference is remote, but file, shell, search, and editing tools execute locally under the active permission policy.