As a developer tool, sigoden/argc has picked up 1.2k stars on GitHub (Rust). A Bash CLI framework, also a Bash command runner.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Argc is a powerful Bash framework that simplifies building full-featured CLIs. It lets you define your CLI through comments, focusing on your core logic without dealing with argument parsing, usage text, error messages, and other boilerplate code.
Features
Effortless Argument Parsing:
Handles flags, options, positional arguments, and subcommands.
Validates user input for robust error handling.
Generates information-rich usage text.
Maps arguments to corresponding variables.
Standalone Bash Script Creation:
Build a bash script that incorporates all functionalities without depending on Argc itself.
Cross-shell Autocompletion:
Generate autocompletion scripts for various shells (bash, zsh, fish, powershell, etc.).
Man Page Generation:
Automatically create comprehensive man page documentation for your script.
Environment Variable Integration:
Define, validate, and bind environment variables to options and positional arguments.
Task Automation:
A Bash-based command runner that automates tasks via Argcfile.sh.
Cross-Platform Compatibility:
Seamlessly run your Argc-based scripts on macOS, Linux, Windows, and BSD systems.
Install
Package Managers
Rust Developers:cargo install argc
Homebrew/Linuxbrew Users:brew install argc
Pacman Users: yay -S argc
Pre-built Binaries
Alternatively, download pre-built binaries for macOS, Linux, and Windows from GitHub Releases, extract it, and add the argc binary to your $PATH.
You can use the following command on Linux, MacOS, or Windows to download the latest release.
curl -fsSL https://raw.githubusercontent.com/sigoden/argc/main/install.sh | sh -s -- --to /usr/local/bin
GitHub Actions
install-binary can be used to install argc in a GitHub Actions workflow.
Argc parses these arguments and creates variables prefixed with argc_:
foo: 1
bar: xyz
baz: a b
val: v1 v2
Just run ./mycli --help to see the automatically generated help information for your CLI:
Usage: mycli [OPTIONS] [VAL]...
Args:
[VAL]... Positional param
Options:
-F, --foo Flag param
--bar <BAR> Option param
--baz [BAZ]... Option param (multi-occurs)
-h, --help Print help
-V, --version Print version
argc reads the comment tags, parses the command line, and prints shell code that
sets the argc_* variables and calls the selected function. The final eval
executes that code, which is why the script works with plain Bash.
With these simple steps, you're ready to leverage Argc and create robust command-line programs!
Comment Tags
Comment tags are standard Bash comments prefixed with @ and a specific tag. They provide instructions to Argc for configuring your script's functionalities.
Tag
Description
@describe
Sets the description for the command.
@cmd
Defines a subcommand.
@alias
Sets aliases for the subcommand.
@arg
Defines a positional argument.
@option
Defines an option argument.
@flag
Defines a flag argument.
@env
Defines an environment variable.
@meta
Adds metadata.
See the comment tag for tag formats and
behavior, and the grammar for formal syntax.
Argcscript
Argc is also a command runner built for those who love the efficiency and flexibility of Bash scripting.
Similar to how Makefile define commands for the make tool, Argcscript uses an Argcfile.sh to store your commands, referred to as "recipes".
Why Choose Argc for Your Projects?
Leverage Bash Skills: No need to learn a new language, perfect for Bash aficionados.
GNU Toolset Integration: Utilize familiar tools like awk, sed, grep, find, and others.
Powerful Shell Autocompletion: Enjoy autocomplete suggestions for enhanced productivity.
Cross-Platform Compatibility: Works seamlessly across Linux, macOS, Windows, and BSD systems.
Use argc --argc-create to quickly generate a boilerplate Argcfile.sh:
argc --argc-create - build test # '-' is an alias for Argcfile.sh
argc build
argc finds Argcfile.sh in the current directory or one of its parents, so you
can run recipes from a subdirectory without changing back to the project root.
See command runner for more details.
Completions
Argc automatically provides shell completions for all argc-based scripts.
argc --argc-completions <SHELL> [CMDS]...
In the following, we use mycli and mycli2 as examples to show how to add a completion script for various shells.
The most recent commit recorded on sigoden/argc was today, based on the GitHub push timestamp. The repository has 61 forks — one of the better signals of community interest.
How many stars does sigoden/argc have?
sigoden/argc has 1.2k GitHub stars — refresh the page for the live number, or check github.com/sigoden/argc. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is sigoden/argc open source?
Yes — sigoden/argc ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/sigoden/argc.
What else is in the Developer Tools space?
sigoden/argc is tracked by TopGit under the Developer Tools category, alongside 11 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is sigoden/argc?
sigoden/argc (sigoden/argc) is a Rust project on GitHub. From the project's own README: A Bash CLI framework, also a Bash command runner.
What language is sigoden/argc written in?
sigoden/argc is written primarily in Rust. GitHub's language field is based on the largest share of bytes in the default branch.
What license does sigoden/argc use?
sigoden/argc is released under the Apache-2.0 license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about sigoden/argc?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/sigoden/argc is the definitive source.
Read full README in the tab above.
Is argc worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of argc.