badBANANA research // GnomeMan4201

manage your operator shell
like a professional

A Textual TUI for navigating, auditing, and extending your alias ecosystem. Built for shells with 100+ aliases and the discipline to keep them organized.

install view on github

live demo

see it in action

self-playing — browse aliases, run commands, apply gap suggestions, inspect health

aliasOS — bad_banana operator profile

aliases [1]

shell [3]

gap analysis [4]

health [5]

alias	command	category	source

select an alias — enter or double-click to run in shell

capabilities

everything your alias ecosystem needs

▤

alias browser

Browse all aliases by category with live search. See source file, line number, and command at a glance. Enter or double-click any row to run it in the shell tab.

◈

ecosystem map

BANANA_TREE layer visualization — OBSERVE, SIMULATE, EXECUTE, ADAPT. Click any tool to probe live status and see registered aliases and root paths.

❯

live shell

Integrated shell that sources your full alias set before executing. Command history, streamed output, clear button. Run aliases without leaving the TUI.

◎

gap analysis

155 curated missing aliases across 22 domains — Docker, testing, linting, Ollama, drift, SSH/GPG, tmux, and more. One-click apply writes directly to your alias files.

✗

health checker

Scans every alias for dead commands, shadowed names, and self-referential loops. Color-coded by severity. Runs on tab open, re-run anytime.

◉

history miner

Parses ~/.bash_history to surface frequent unaliased commands. Shows count and suggested alias name. One click to promote any command into a permanent alias.

⌥

git context

Detects the current repo, shows branch and remote, loads per-repo alias overrides. Create repo-scoped aliases that activate on cd.

◆

full crud

New, edit, delete aliases with file picker and ctrl+s to save. Writes back to the source .sh file in place. ctrl+e exports all aliases to a single clean file.

getting started

install

# requirements: python 3.10+
pip install textual

# clone and run
git clone https://github.com/GnomeMan4201/aliasOS.git
cd aliasOS
python3 aliasOS_tui.py

alias modules

Nine alias modules covering 378 aliases + functions. Install individually or all at once:

# copy modules to your ~/.aliases.d/
cp aliases/*.sh ~/.aliases.d/

# reload
source ~/.aliases.d/loader.sh

manage your operator shelllike a professional

manage your operator shell
like a professional