tman drops an interactive HUD directly over your shell prompt with Ctrl+Shift+T (or Ctrl+Space), enabling directory navigation, project workflow execution, history search, and system telemetry without interrupting your active workflow.
curl -fsSL https://raw.githubusercontent.com/IamShreshth/Tman/main/files/install.sh | bashsource ~/.zshrc # If using Zsh
# OR
source ~/.bashrc # If using BashPress Ctrl+Shift+T (or Ctrl+Space) anywhere in your shell, or run tman.
- Zero-Daemon HUD: Ephemeral full-screen overlay that takes ownership of the terminal buffer and releases it cleanly on exit.
- System Telemetry: Real-time inspection of battery status, CPU load averages, memory allocation, volume capacity, and active Git branch state.
- Workflow Discovery: Automatically senses repository types (Rust, Python, Node, Go, Docker, Make) and compiles actionable targets.
- Navigation & Bookmarks: Fast directory traversal with persistent directory pinning and in-prompt
cdintegration.
| Key | Context | Action |
|---|---|---|
Ctrl+Shift+T / Ctrl+Space |
Shell | Toggle HUD overlay |
Up / Down or j / k |
Navigation | Move cursor selection |
Enter |
Any View | Execute selected action / cd into folder |
Right / l |
File Browser | Open highlighted directory |
Left / h / Backspace |
Submenus | Navigate to parent directory / previous view |
b |
Menu / Files | Bookmark current directory or highlighted folder |
d or x |
Bookmarks | Delete highlighted bookmark |
Tab |
Browser / Runners | Open action menu / insert command into shell |
/ |
Lists | Filter items with fuzzy search |
. |
File Browser | Toggle hidden dotfiles |
m |
Submenus | Return to main menu |
Esc |
Any View | Clear search / close modal / exit HUD |
Ctrl+C / Ctrl+D |
Any View | Terminate overlay |
tman is written in Rust and compiles to a standalone, zero-dependency native binary. No external runtimes (Python, Node.js) are needed.
| Component | Requirement |
|---|---|
| Operating System | macOS (Apple Silicon & Intel) or Linux (x86_64, aarch64) |
| Supported Shells | Zsh (v5.0+) or Bash (v4.0+) |
| Build Toolchain | Rust 1.70+ and Cargo (only when building from source) |
See docs/requirements.txt for technical specifications.
cargo install --git https://github.com/IamShreshth/Tman.git --locked
echo 'eval "$(tman init zsh)"' >> ~/.zshrcgit clone https://github.com/IamShreshth/Tman.git
cd Tman
./files/install.shrm -f ~/.local/bin/tman ~/.cargo/bin/tman
rm -rf ~/.config/tmanRemove the eval "$(tman init ...)" line from your ~/.zshrc or ~/.bashrc.
Licensed under the MIT License.