# bashly-framework/bashly

Bash command line framework and CLI generator

Repository: https://github.com/bashly-framework/bashly
Canonical: https://ross.abutalabs.com/products/bashly
Homepage: https://bashly.dev
Language: Ruby
License: MIT
License Family: permissive
Topics: bash, ruby, cli-generator, cli-framework, code-generator, cli, bash-scripting
Last push: 2026-08-24T10:44:30+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 92, longevity 100
- inputs: {"age_days": 2479, "days_push": 9, "days_rel": 55, "gap_med": 25, "n_releases_24m": 20}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2448, forks 95 (observed 2026-08-28T04:06:52.720990+00:00)

## What it is
Bashly is a Ruby-based command line tool that generates feature-rich, standalone bash CLI scripts from a simple YAML configuration file. It handles argument parsing, validation, usage/help text, subcommands, bash completions, and documentation generation so developers only write their core command logic.

## Use cases
- generate a bash CLI tool with subcommands from a YAML spec
- add argument parsing and validation to a bash script
- auto-generate usage help text and man pages for a shell tool
- create bash completions for my command line script
- build a shellcheck-compliant single-file bash script
- scaffold a CLI wrapper around internal scripts

## When to choose
- you want to write CLI tools in bash without hand-rolling argument parsing
- you need a single standalone script with no runtime dependencies beyond bash 4.2+
- you want automatic help text, completions, and docs from one config file

## When to avoid
- you need performance or complex data structures beyond what bash offers
- you prefer writing CLIs in a compiled or higher-level language
- your target environments lack bash 4.2 or higher

## Facets
- artifact type: cli-tool
- maturity: stable
- function: cli, developer-tools, parser, documentation
- domain: developer-tools, documentation
- platform: cli, cross-platform, windows
- tags: bash, yaml-config, cli-generator, shell-scripting, ruby-gem, bash-completions, man-pages, code-generator, command-line, automation, linux, macos, docker

## Member repositories
- bashly-framework/bashly (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:52.720990+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:30:27.825637+00:00, confidence not recorded.
  - readme: https://github.com/bashly-framework/bashly (fetched 2026-08-28T04:06:52.720990+00:00, sha 13a5f5232988)
  - homepage: https://bashly.dev (fetched 2026-08-29T10:11:41.489031+00:00, sha 67d0de2011a7)
  - site_page: https://bashly.dev/installation (fetched 2026-08-29T10:11:41.491570+00:00, sha c43d5858731c)
- Data as of 2026-08-30T08:39:29.467469+00:00.