Version 0.1.0 • Native macOS & Linux

A Context-Aware Interactive HUD
Over Your Terminal

Press Ctrl+Shift+T or Ctrl+Space anywhere in your active shell to trigger an ephemeral full-screen control center. Inspect vitals, switch directories, run project workflows, and traverse command history instantly.

$ curl -fsSL https://raw.githubusercontent.com/IamShreshth/Tman/main/files/install.sh | bash

Zero-Daemon Overhead Pure Standalone Rust Linux & macOS Zsh, Bash & Fish

See It in Action

Try the interactive simulator or inspect the real live terminal overlay.

tman ⎇ main ↑1 ↓0 +2 ~1 ?0

ACTIONS

❯ ▸ Navigate Browse and jump between directories
* Bookmarks Quick jump to pinned & recent directories
↺ History Search your real shell history
⌕ Search Find files and folders (.gitignore-aware)
⎇ Git Stage files, switch branches & pop stashes
▶ Run Commands discovered in this project
◈ Ports Inspect listening ports & kill processes
# Theme Choose an accent color theme

MISSION CONTROL

━━━ SYSTEM VITALS ━━━━━━━━━━━━━━━━━━━━

Power: 84% (discharging)

Uptime: 10d 13h 58m

Load: 1.42 1.25 1.10

RAM: 7.2 GB / 16.0 GB (45%)

Disk: 245.8 GB free (68% used)

━━━ CONTEXT ━━━━━━━━━━━━━━━━━━━━━━━━━━

Dir: ~/projects/app

Git: ⎇ main +2 ~1 ?0

Project: Rust, Docker, Env

━━━ DIRECTORY CONTENTS ━━━━━━━━━━━━━━━

▸ src/

▸ tests/

Cargo.toml

Dockerfile

README.md

Engineered for Flow

Everything you need from your shell without tmux splits, multiplexer gymnastics, or leaving your prompt.

Zero-Daemon Architecture

No persistent background server running in the background. Pressing your hotkey spawns a sub-millisecond ephemeral layer that owns the terminal buffer and releases it cleanly.

Real-Time Vitals

Direct kernel inspection of battery percentage, CPU load averages, physical RAM, disk capacity, and Git working tree state via native OS APIs (sysfs/procfs on Linux, sysctl on macOS).

Smart Workflow Discovery

Automatically inspects repository roots and synthesizes runnable commands for Cargo, npm/pnpm/yarn/bun, Python venvs/pytest/poetry, Go, Docker Compose, Make, CMake, and Just.

Bookmarks & Quick Jumps

Pin your most frequent directories with a single key (b). Jump directly to them or `cd` seamlessly straight back into your shell prompt.

Fuzzy Real-History Search

Pulls your live command history with deduplication and fuzzy sub-sequence matching. Auto-cleans timestamp clutters and pre-fills complex commands for editing.

Desktop & Clipboard Hooks

Press Tab on any file or folder to trigger actions: open in default application (`xdg-open` / `open`), launch file manager, or copy absolute paths into Wayland/X11/macOS clipboards.

Ergonomic Keyboard Shortcuts

Designed for pure keyboard navigation with familiar Vim keys and standard shell shortcuts.

Key	Context	Action
`Ctrl+Shift+T` / `Ctrl+Space`	Shell	Toggle HUD overlay (`Ctrl+Space` is ideal on Linux)
`↑` `↓` or `j` `k`	Navigation	Move cursor selection
`Enter`	Any View	Execute selected action / `cd` into folder
`→` or `l`	File Browser	Enter highlighted directory
`←` or `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
`Space`	Git Changed Files	Stage / unstage highlighted file in-place
`Q`	File Browser	Quit HUD and `cd` shell into the browsed directory
`Tab`	Browser / Runners	Open action menu (Open with app, Open in file manager, Copy path)
`/`	Lists	Filter items with multi-word fuzzy search
`.`	File Browser	Toggle hidden dotfiles
`m`	Submenus	Return to main menu
`Esc`	Any View	Clear search / close modal / exit HUD

Quick Installation

One command. That's it.

Paste this in your terminal — it installs tman and wires up your shell hook automatically:

curl -fsSL https://raw.githubusercontent.com/IamShreshth/Tman/main/files/install.sh | bash

Then reload your shell: source ~/.zshrc · Press Ctrl+Shift+T to open tman.

Same single command — auto-detects your distro, arch (x86_64 / aarch64), and libc (glibc / musl):

curl -fsSL https://raw.githubusercontent.com/IamShreshth/Tman/main/files/install.sh | bash

Then reload your shell: source ~/.bashrc · Use Ctrl+Space on Linux (many terminals intercept Ctrl+Shift+T).

A Context-Aware Interactive HUD Over Your Terminal