drift

A TUI command vault for your shell. Save, search, and execute commands you use often but can never quite remember.

Install

npm install -g @brechtknecht/drift

Usage

drift          # open the TUI browser
drift add      # add a new command interactively
drift add "git log --oneline -20"                                      # pre-fill the command
drift add "cd /project && npm run dev" --desc "Start dev" --tags "node,dev"  # save without TUI
drift remove <id>

TUI controls

| Key | Action | |-----|--------| | ↑ / ↓ | Navigate | | Shift+↑ / Shift+↓ | Reorder | | / | Enter search mode | | ESC | Exit search / quit | | Enter | Execute command | | Ctrl+E | Copy to clipboard | | a | Add new command | | e | Edit selected | | Ctrl+D | Delete selected |

Commands

Each saved command has:

• Description — what it does
• Command — the shell command
• Directory (optional) — when set, executing or copying prepends cd <dir> &&
• Tags — for organisation and search

Search

Press / to enter search mode. Fuzzy search across command text, description, and tags. Press Enter to lock the filter, ESC to clear.

Data

Commands are stored at ~/.config/drift/commands.json.