Introduction

The reusable packages are documented under Packages.

• structargs turns a Zig struct into a command-line interface, including flags, defaults, enums, subcommands, and help text.
• csv parses delimited text into rows and fields for CSV- and TSV-style CLI workflows.
• pretty-table prints aligned and formatted tables for terminal output.
• gitignore parses and applies .gitignore rules in pure Zig.
• term provides terminal styling and capability helpers such as ANSI colors and terminal width detection.

The root import is zigcli:

1
2
3

const zigcli = @import("zigcli");
const structargs = zigcli.structargs;
const pt = zigcli.pretty_table;

Generated API documentation for the exported packages is available at apidocs.

The standalone tools are documented under Programs.

Some highlights:

• loc counts lines of code across languages
• tree prints directory trees with optional filtering
• pretty-csv renders CSV and TSV files as aligned tables
• zfetch prints system information
• cowsay, repeat, and other small terminal utilities round out the collection

The programs and packages are developed in the same repository, so the binaries can also serve as examples of how the reusable modules fit together.

See INSTALL page.

Two common paths are:

• install prebuilt binaries with the shell installer
• add zigcli as a Zig dependency and use the packages directly

For binaries:

1

curl -fsSL https://zigcli.liujiacai.net/install.sh | sh

For package use, see the install page and the package docs for the current build.zig integration pattern.

• src/ contains the Zig source code

  • src/bin/ standalone CLI programs
  • src/ reusable packages exported through the zigcli root module
• examples/ contains small demo programs
• docs/ contains this website and the package/program documentation

If you're using zigcli, and would like to be added here, welcome to open a PR.

MIT, see LICENSE for details.