# kareman/SwiftShell

A Swift framework for shell scripting.

Repository: https://github.com/kareman/SwiftShell
Canonical: https://ross.abutalabs.com/products/swiftshell
Homepage: https://kareman.github.io/SwiftShell
Language: Swift
License: MIT
License Family: permissive
Topics: swift, shell, command-line, script, swift-library
Last push: 2026-03-26T20:40:11+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 74, release rhythm 44, longevity 100
- inputs: {"age_days": 4390, "days_push": 160, "days_rel": 160, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1060, forks 86 (observed 2026-08-28T04:03:25.823841+00:00)

## What it is
SwiftShell is a Swift library for creating command-line applications and running shell commands from Swift code. It provides process execution with output handling, asynchronous command running, and access to execution contexts like environment variables, standard streams, and the working directory.

## Use cases
- run shell commands from swift
- write command-line scripts in swift
- capture command output in a swift app
- run shell commands asynchronously
- build cli tools with swift package manager
- read and write files from a swift script

## When to choose
- you want to script shell tasks in Swift instead of Bash
- you need fine-grained control over process contexts, streams, and errors
- you are building a command-line tool in Swift on macOS or Linux

## When to avoid
- you need a full argument parser (pair it with Moderator)
- you only target Apple platforms with Process/Foundation already sufficient
- you need cross-platform support beyond macOS and Linux

## Facets
- artifact type: library
- maturity: active
- function: cli, developer-tools, file-system, error-handling
- domain: developer-tools
- platform: -
- tags: shell-scripting, swift-package-manager, process-execution, streams, command-line, automation, macos, linux, swift

## Member repositories
- kareman/SwiftShell (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:25.823841+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:56:57.623056+00:00, confidence not recorded.
  - readme: https://github.com/kareman/SwiftShell (fetched 2026-08-28T04:03:25.823841+00:00, sha 23ec9f160118)
  - homepage: https://kareman.github.io/SwiftShell (fetched 2026-08-29T12:58:43.842060+00:00, sha 7435095e0f9a)
- Data as of 2026-08-30T08:39:29.467469+00:00.