# Install argc with Homebrew, MacPorts, Nix

Easily create and use cli based on bash script. Version 1.24.0 via Homebrew; verified 2026-05-20.

## Install

```sh
sudo av install brew:argc
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install argc
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install argc
```

  Evidence: MacPorts ports tree: devel/argc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#argc
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ar/argc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:argc
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/argc>
- **Version:** 1.24.0
- **Source summary:** Easily create and use cli based on bash script
- **Homepage:** <https://github.com/sigoden/argc>
- **Repository:** <https://github.com/sigoden/argc>
- **Upstream docs:** <https://github.com/sigoden/argc#readme>
- **License:** Apache-2.0 OR MIT
- **Source archive:** <https://github.com/sigoden/argc/archive/refs/tags/v1.24.0.tar.gz>
- **Last updated:** 2026-05-20T06:35:58Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- argc (cli)
- argc (alias)

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.24.0
- Package-manager updated: 2026-05-20
- Local data: ok
- Upstream repository: https://github.com/sigoden/argc
- Upstream latest detected: v1.24.0 (current)
## Project history and usage

Argc is a Rust-distributed command-line tool for writing Bash CLIs and command runners from annotated shell comments. It generates argument parsing, usage text, completions, man pages, and standalone Bash scripts while keeping the user's command logic in ordinary shell functions.

### Project history

The GitHub repository was created in February 2022, and the earliest GitHub release visible through the releases API is v0.2.1 from the same month. The project has since grown into a 1.x tool with documented specifications for comment tags such as `@cmd`, `@arg`, `@option`, `@flag`, `@env`, and `@meta`.

### Adoption history

The README documents installation through Cargo, Homebrew/Linuxbrew, AUR, release binaries, a shell installer, and GitHub Actions. Homebrew builds it as a Rust formula, generates completions, and tests command-runner creation with `argc --argc-create`, which reflects its dual role as both parser generator and task runner.

### How it is used

In CLI mode, a script adds comment tags above Bash code and evaluates `argc --argc-eval` to bind parsed arguments into `argc_` variables. In command-runner mode, users keep recipes in `Argcfile.sh`, generate one with `argc --argc-create`, and run recipes much like a Makefile-style task runner.

### Why package nerds care

Argc is package-nerd bait because it gives Bash scripts a structured CLI surface without forcing a rewrite in Go, Rust, Python, or Node. It also sits at an interesting boundary: installed as one compiled binary, but primarily useful for making shell scripts more distributable, documented, and completion-friendly.

### Timeline

- 2022: GitHub repository created.
- 2022: v0.2.1 published as the earliest GitHub release visible through the releases API.
- 2024: v1.x line continues with regular feature releases.
- 2026: v1.24.0 published and packaged by Homebrew.

### Related projects

- The README points to argc-completions for shell-completion behavior and install-binary for GitHub Actions installation, tying argc to the author's small-tool ecosystem around command-line distribution.

### Sources

- <https://api.github.com/repos/sigoden/argc>
- <https://api.github.com/repos/sigoden/argc/releases>
- <https://github.com/sigoden/argc#readme>
- <https://github.com/sigoden/argc/blob/main/docs/command-runner.md>
- <https://raw.githubusercontent.com/Homebrew/homebrew-core/HEAD/Formula/a/argc.rb>


## Security Notes

No matching local secret-handling manifest was found for argc. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: Argcfile.sh
- Windows: Argcfile.sh
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** argc
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - argc: normalized package name match | nixpkgs package indexes: pkgs/by-name/ar/argc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - argc: normalized package name match | MacPorts ports tree: devel/argc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [aliae](https://www.automicvault.com/pkg/brew/aliae/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [atuin](https://www.automicvault.com/pkg/brew/atuin/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [atuin-server](https://www.automicvault.com/pkg/brew/atuin-server/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [babelfish](https://www.automicvault.com/pkg/brew/babelfish/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [bar](https://www.automicvault.com/pkg/brew/bar/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [bash-language-server](https://www.automicvault.com/pkg/brew/bash-language-server/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [bashdb](https://www.automicvault.com/pkg/brew/bashdb/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [beakerlib](https://www.automicvault.com/pkg/brew/beakerlib/) - Shares av.db curated category or tags: cli, developer-tools, shell.
- [create-dmg](https://www.automicvault.com/pkg/brew/create-dmg/) - Local package facts share a topical domain. Shared terms: cli, create, developer, developer-tools, script.
- [semtag](https://www.automicvault.com/pkg/brew/semtag/) - Local package facts share a topical domain. Shared terms: bash, cli, developer, developer-tools, script.
- [shfmt](https://www.automicvault.com/pkg/brew/shfmt/) - Local package facts share a topical domain. Shared terms: bash, cli, developer, developer-tools, script.

## Combined YAML source

View the package source record on GitHub. [combined/argc.yml](https://github.com/automic-vault/db/blob/main/combined/argc.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
