Repository navigation
Wizard and TUI
Start the project Wizard:
binman wizardAnswer the questions, review the summary, and approve generation. The Wizard
can create single files or applications in Bash, Python, Node, TypeScript,
Go, Rust, Ruby, and PHP. Python apps can receive a .venv immediately.
It can also initialise Git and create a Docker or Podman configuration when you choose a container mode. Less typing, fewer mysterious folders, more actual project.
The Wizard gathers project name, type, language, destination, description, author, Python environment choice, Git options, and container options before writing anything. It then prints a summary and requests final approval.
Generated applications are stored under the selected project directory and
receive a README, version metadata, language-specific launcher files, and an
app manifest. Container projects receive a Dockerfile, .dockerignore, and
BinMan container metadata under:
~/.local/share/binman/docker/<app>.json
The Wizard is opinionated and intentionally fast. Use it when you want a
repeatable scaffold; use binman install when you already have a project and
want BinMan to manage it.
Run:
binmanUse the arrow keys or the shortcut letters, then press Enter. The menu covers installation, removal, listing, diagnostics, Docker, bundled scripts, Wizard, backup, restore, rollback, bundle, and tests.
The TUI is a terminal front end over the same operation functions used by the
CLI. It needs a real interactive terminal. --no-clear can help when
capturing output or debugging terminal behaviour.
The display is not a second implementation of every feature: selecting an
action dispatches into the same Bash paths documented elsewhere. If a TUI
result surprises you, repeat the equivalent CLI command with
BINMAN_DEBUG=1.