Back to browse
GitHub Repository

A pure POSIX shell framework to create powerful CLIs

21 starsShell

Shifu – A pure POSIX shell framework to create powerful CLIs

by ultramann·Mar 30, 2026·7 points·2 comments

AI Analysis

●●SolidCozyBig Brain

Pure POSIX DSL generates help and tab completion without Python or external dependencies.

Strengths
  • Single-file dependency-free design simplifies distribution across diverse Unix environments.
  • Declarative DSL handles argument parsing and subcommand dispatch cleanly within shell.
  • Auto-generated tab completion works across bash, zsh, dash, and ksh shells.
Weaknesses
  • Shell scripting limitations make complex logic harder than Python or Go.
  • Low adoption means fewer community plugins compared to established CLI frameworks.
Target Audience

DevOps engineers, sysadmins, and shell script maintainers

Similar To

bashly · shflags · argbash

Post Description

The startup I work for has an internal, bash-based, cli that basically amounts to shared aliases with a common entrypoint. As the number of aliases has grown, I've had a desire to group functionality together in subcommands, add more help strings, and have better tab completion. I know I could convert it to, e.g., a python script, but I was curious what was possible if we continued to use bash.

I couldn't find anything that solved those problems without lots of extra machinery. I understand why, shell scripts are generally not long, and focused on a dedicated task; adding cli features to them is mostly unnecessary, many might even discourage it for many valid reasons.

Nonetheless, I considered writing this functionality myself, but that felt like a poor use of company time. So I started toying with what a framework to handle those concerns entirely in shell script would look like on the side. Thus, shifu was born. I've been working on it off and on for about a year, and think I've got a reasonable alpha release, so thought I'd share.

Similar Projects

Design●●Solid

Animated ASCII art in pure SVG

Pure SVG ASCII animations with typing and glitch effects look surprisingly smooth.

Eye CandyCozy
syi0808
222mo ago