bruno-de-queiroz

bruno-de-queiroz / oosh

Public

Annotation-driven bash CLI framework — flags, help, and tab completion for free

autocompletion bash bash-framework cli cli-framework
18
0
100% credibility
Found Feb 27, 2026 at 13 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Oosh is a framework for creating bash command-line tools using simple annotations that automatically add help text, option handling, and typing suggestions.

How It Works

1
🔍 Find Oosh

You stumble upon Oosh, a handy way to make your own command-line helpers that feel smart and easy to use.

2
📥 Grab the starter

With one quick command, you download the tool maker to start building right away.

3
✨ Build your first helper

Pick a name for your tool, and it creates a full setup with sample commands ready to tweak.

4
📝 Add your commands

Drop simple note-filled scripts into a folder, describing what each action does and its options.

5
🚀 Set it up for easy access

Run the install option, and it places your tool where you can use it from anywhere in your terminal.

6
🪄 Experience the magic

Type your tool's name, see instant help and smart suggestions appear as you type commands.

🎉 Powerful tools made simple

Now you have a professional-feeling command-line app that grows with your needs, saving time every day.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 13 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is oosh?

oosh is an annotation-driven bash CLI framework that lets you add comments above functions in shell scripts to automatically generate flag parsing, help text, and tab completion. Drop a few lines like "#@flag -e|--env VAR 'default' enum(dev,prod)" and your bash 3.2+ tool handles options, validation, and zsh/bash autocompletion with no extra dependencies. A generator command spins up full CLIs in seconds, auto-discovering modules you add later.

Why is it gaining traction?

It slashes boilerplate—45 lines of annotations replace 130+ of manual case statements and getopts—while adding 6-17ms overhead on real workloads. Built-in tools like lint for annotation errors (with auto-fix), trace for completion perf, and agent-friendly module drops make iteration fast. Pure bash means it runs anywhere without installs, unlike heavier frameworks.

Who should use this?

DevOps engineers scripting deploy tools, sysadmins building quick utilities like log analyzers, or backend devs prototyping bash CLIs for Kubernetes or AWS. Perfect for solo hackers wanting tab completion and typed flags (file/dir/boolean/enum) without leaving shell.

Verdict

Grab it for bash-heavy workflows—docs are thorough, perf solid—but with 12 stars and 1.0% credibility, treat as experimental; test in non-prod first. Generator and uninstall make it low-risk to try.

(187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.