Repository navigation
Home
A personal command manager for scripts and small applications.
Because ~/Downloads is not a filing system, champ.
BinMan turns loose scripts and small projects into commands you can run from anywhere. It is local, Bash-powered, deliberately practical, and just cheeky enough to stop your toolbox becoming a digital landfill.
| You want to... | Read this |
|---|---|
| Install BinMan and your first tool | Getting Started |
| Understand the command set | Commands |
| Need every flag and edge case | Full Command Reference |
| Use the interactive interfaces | Wizard and TUI |
| Manage Python apps or manifests | Applications, Manifests, and Python |
| Manage containers | Docker and Podman |
| Protect or recover your tools | Backups and Recovery |
| See the tools BinMan ships with | Bundled Scripts |
| Read every bundled-script detail | Bundled Script Reference |
| Understand where files live | Internals |
| Understand safety and portability | Safety, Portability, and Limitations |
| Fix something that has gone sideways | Troubleshooting |
Install a script:
binman install ./my-tool.sh
my-toolInstall a project directory:
binman install ./MyApp
MyAppBinMan is a single Bash executable. A file install creates a command in
~/.local/bin; a directory install stores an app under
~/.local/share/binman/apps/<name> and creates a shim in ~/.local/bin.
Metadata and inventory state live under ${XDG_STATE_HOME:-~/.local/state}/binman.
BinMan is a personal tool manager, not a replacement for apt, dnf, pacman,
or another distribution package manager. It manages the little tools that
those systems were never going to package for you.
Most pages use two layers:
- Noob mode: what it does and the shortest useful command.
- Pro mode: how it works, where it stores things, dependencies, failure modes, and the assumptions K.A.R.I. made at 2 AM.
For the compact terminal reference, see the repository's binman.1.