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:

Favorites
Most frequently used
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.