Usage

Start TRX by simply running:

trx

TRX will detect your system's package manager automatically and open the TUI.

Tabs

TRX has three tabs, cycled with Tab / Shift+Tab:

TabDescription
SearchFuzzy-search all available packages
InstalledBrowse packages currently installed on the system
UpdatesPackages with a newer version available

Keybindings

Global

KeyAction
TabSwitch to next tab
Shift+TabSwitch to previous tab
?Toggle help overlay
q / EscQuit TRX (or exit current mode)
KeyAction
↑ / kMove selection up
↓ / jMove selection down

Package Operations

KeyAction
SpaceToggle package selection
iInstall all selected packages
xRemove all selected packages
UFull system upgrade
RRefresh package databases

Search Tab

KeyAction
eEnter search / editing mode
EscExit search mode (return to normal navigation)

Workflow Example

  1. Press e to enter search mode.
  2. Type a package name (e.g. ripgrep). Results appear within 50 ms as you type.
  3. Use ↓ / j to move through results. The details panel on the right updates automatically.
  4. Press Space to select one or more packages.
  5. Press i to install the selection.

Command-line Options

TRX accepts a small set of flags when called from the command line (before the TUI starts):

trx [OPTIONS]

Options:
  -v, --version    Print version information
  -h, --help       Print help information