# shellfire-dev/shellfire

A repository of namespaced, composable shell (bash, sh and dash) function libraries. Takes aware the pain of shell scripting, making it robust and reusable. Includes secure curl usage, JSON, XML and Debian control file parsers, dependency documentation via attributes, and more. Batteries ARE included.

Repository: https://github.com/shellfire-dev/shellfire
Canonical: https://ross.abutalabs.com/products/shellfire
Homepage: https://github.com/shellfire-dev/shellfire
Language: Shell
License: NOASSERTION
License Family: other
Last push: 2015-12-14T08:58:38+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4374, "days_push": 3915, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1225, forks 51 (observed 2026-08-28T04:04:03.035029+00:00)

## What it is
A MIT-licensed framework of namespaced, composable function libraries for building modular applications in POSIX-compliant shell (bash, sh, dash). It abstracts shell interpreter differences, provides parsers for JSON/XML/Debian control files, secure curl usage, CLI argument parsing, and tooling to build standalone deployable scripts.

## Use cases
- write robust shell scripts that work across bash, sh and dash
- parse JSON or XML from shell scripts without external binaries
- build standalone single-file shell applications with embedded resources
- automatically detect and install script dependencies
- parse command-line arguments with long options and help messages
- manage hierarchical configuration files for shell tools

## When to choose
- you maintain portable shell scripts that must run on multiple shells and platforms
- you need structured data parsing (JSON, XML) in pure shell
- you want to package shell applications as standalone scripts or debs

## When to avoid
- you are writing complex applications better suited to Python or Go
- you need an actively developed project - the latest release dates to 2015
- your team is not comfortable with shell scripting idioms

## Facets
- artifact type: framework
- maturity: maintenance
- function: parser, http-client, cli, configuration-management, serialization, developer-tools
- domain: developer-tools, parsers
- platform: bsd, cli, cross-platform
- tags: shell-scripting, posix-shell, bash, modular-libraries, standalone-scripts, json-parsing, xml-parsing, dependency-management, command-line, automation, linux, macos

## Member repositories
- shellfire-dev/shellfire (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:03.035029+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-30T06:15:24.313855+00:00, confidence not recorded.
  - readme: https://github.com/shellfire-dev/shellfire (fetched 2026-08-28T04:04:03.035029+00:00, sha 32d2648c633c)
  - homepage: https://github.com/shellfire-dev/shellfire (fetched 2026-08-29T12:23:19.216023+00:00, sha 523aa4648aa9)
- Data as of 2026-08-30T08:39:29.467469+00:00.
