u

A minimal, colorful and sleek terminal file manager for macOS.

 u — keybindings

╭──────────────────────────────────────────────────────╮
│  NAVIGATION              SELECTION                   │
│  j / ↓   move down       space   toggle mark         │
│  k / ↑   move up         x       cut selection       │
│  h / ←   parent dir      y       copy selection      │
│  l / →   open            p       paste here          │
╰──────────────────────────────────────────────────────╯

• Vim-like navigation — j/k/h/l, arrow keys, g/G to jump top/bottom
• Split-pane preview — see the contents of text files, source code, and directories without opening them
• Archive peeking — look inside .zip and .tar.gz/.tgz files without extracting
• Cut / copy / paste — move or duplicate files and folders, with smart name-collision handling
• Multi-select — mark several files at once for bulk delete/cut/copy
• Themes — five preinstalled color themes (default, dracula, nord, gruvbox, mono), switchable at launch with --theme or on the fly with T
• Git-aware — folders containing a .git directory are highlighted in purple
• Language-aware colors — .py, .js, .rb, .c/.cpp, .rs files get distinct colors at a glance
• In-app help — press u or ? anytime for a full keybinding reference

• macOS (Ruby ships preinstalled)
• A terminal emulator that supports ANSI escape codes (Terminal.app, iTerm2, etc..)

Quick install (recommended):

curl -fsSL https://raw.githubusercontent.com/ufuayk/u/macos/install.sh | bash

This downloads the source and installs it under share/u (the launcher u goes on your PATH; falls back to ~/.local/bin if you don't have write access to /usr/local/bin or sudo).

Manual install (not recommended):

git clone --branch macos https://github.com/ufuayk/u
cd u
./u.rb

Running ./u.rb straight from a clone works because the entry point loads the modules next to it with require_relative. To put it on your PATH yourself, install the launcher and payload as install.sh does, or simply symlink from a directory that keeps u.rb and libr/ together.

u                          # opens in your home directory (default)
u /path/to/somewhere       # opens in a specific directory
u --start /path/to/dir     # same as above, explicit flag form
u --width 100 --height 30  # override the forced terminal size (default 136x40)
u --no-resize              # don't force-resize the terminal at all
u --theme dracula          # pick a color theme (default: default)
u --themes                 # list available themes and exit
u --help                   # print CLI usage and exit

By default, u asks your terminal to resize itself to 136×40 on launch — that's the size it's tuned for. Most modern terminal emulators honor this automatically; if yours doesn't, the layout still adapts gracefully to whatever size you have.

Press u or ? inside the app anytime — the full reference above is always one keypress away.

Toggle it with v. It shows, on the right half of the screen:

• Text & source files (.txt, .md, .py, .js, .rb, .sh, .c, and more) — the actual file contents, read-only. Nothing is ever executed.
• Directories — a quick listing of what's inside.
• .zip / .tar.gz / .tgz archives — the list of files inside the archive, with sizes, without extracting anything to disk.

• y copies the current (or marked) entries to an in-memory clipboard. It persists — paste it into as many places as you like.
• x cuts them instead. Cut is one-shot: it clears itself after a single paste (a move).
• p pastes into whatever directory you're currently browsing.
• Pasting into a directory that already has a file with the same name won't overwrite it — u automatically names the copy file copy.ext, file copy 2.ext, and so on, the same way Finder does.

Five themes ship with u:

• Everything is implemented with Ruby's standard library only — io/console, fileutils, zlib. No rubyzip, no third-party gems, no network calls.
• The .zip reader parses the ZIP central directory by hand; the .tar.gz reader parses USTAR headers over a Zlib::GzipReader stream. Both only list archive contents — extraction isn't implemented (yet).
• The code is split into small libr/ files (color, themes, zip_peek, tar_gz_peek, terminal, file_ops, preview, renderer, app), pulled together by the u.rb entry point with require_relative. Running ./u.rb from a clone just works.
• Rendering is theme-driven: the app never hardcodes a color, it asks the active theme for a role (:dir, :error, :help_key, ...). Colors are disabled automatically when stdout isn't a TTY.

MIT.