tui²

tui2 is a terminal UI launcher for other terminal UI apps. It detects common TUIs installed on your computer, lets you add your own commands, and prioritizes favorites and frequently used tools.

Run

cargo run

Controls

| Key | Action | | --- | --- | | / | Search launchers | | j / Down | Move down | | k / Up | Move up | | Enter | Launch selected TUI | | a | Add a custom launcher | | f | Favorite or unfavorite selected launcher | | r | Rescan detected and saved launchers | | q / Esc | Quit |

Search mode fuzzy-matches launcher names, commands, and descriptions. Press Backspace to edit the search and Esc to clear it.

How Launchers Are Chosen

Launchers are sorted in this order:

1. Favorites
2. Most frequently used
3. Name

The list shows each launcher's source and usage, for example:

[fav] Neovim  [auto | used 4x]
Lazygit       [auto | never used]
Notes         [user | used once]

Config Files

Custom launchers are saved here:

~/.config/tui2/launchers.txt

Format:

name<TAB>command<TAB>description

Usage stats and favorites are saved here:

~/.config/tui2/stats.txt

Format:

command<TAB>launch_count<TAB>favorite

Code Layout

| File | Purpose | | --- | --- | | src/main.rs | App startup | | src/app.rs | App state, keyboard input, add flow, launching | | src/ui.rs | Ratatui layout and rendering | | src/launcher.rs | Launcher model, auto-detection, config, stats, sorting | | src/terminal.rs | Terminal setup/restore and shell command execution |

To add or remove auto-detected programs, edit known_tui_programs() in src/launcher.rs.