Introduction on Zigcli

Install

Thu, 02 Jan 2025 23:20:23 +0800

CLI Programs

Quick Install (recommended)

1

curl -fsSL https://jiacai2050.github.io/zigcli/install.sh | sh

This installs all binaries packaged in the latest release to ~/.local/bin by default.

Options:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# Custom install directory
curl -fsSL ... | sh -s -- --install-dir /usr/local/bin

# Install all packaged binaries explicitly
curl -fsSL ... | sh -s -- --bins all

# Choose which binaries to install
curl -fsSL ... | sh -s -- --bins "loc zfetch tree cowsay"

# Pin a specific version
curl -fsSL ... | sh -s -- --version v0.4.0

# Use mirror for users in China
curl -fsSL ... | sh -s -- --china

Release binary CPU targets

The prebuilt release binaries use conservative CPU targets so the same archive can run on older machines:

x86_64 release binaries are built with haswell
aarch64-macos release binaries are built with apple_m1
aarch64-windows release binaries are built with cortex_a76
other aarch64 targets currently use generic

If those defaults do not match your deployment needs, build from source and choose your own -Dcpu target.

Build from source

1

git clone https://github.com/jiacai2050/zigcli.git

Then build with zig 0.17.0

1

make build

structargs

Sat, 21 Oct 2023 12:04:40 +0800

structargs turns a Zig struct into a command-line interface.

Instead of building a parser through chained builder calls, you declare one options struct, and structargs derives the flags, defaults, enums, subcommands, and help output from that type at comptime.

Features

The CLI schema lives in one Zig struct:
- normal fields become options
- optional fields and default values become optional flags
- __shorts__ declares short aliases
- __messages__ declares help text
Nested subcommands are declared with __commands__: union(enum)
Help and usage text are generated from the same type definition
--version support is enabled through version_string
print_help_on_error can print stderr help before returning parse errors
Supported option value types include:
- All primitive types, such as i8, u16, f32, bool
- []const u8
- Enum

pretty-table

Sat, 17 Aug 2024 17:48:29 +0800

pretty-table provides two table types plus one owning helper:

Table(N) — fixed-size rows and fixed column count, both known at comptime.
Table(N).Owned — runtime row collection for Table(N), while keeping the same fixed column count.
RuntimeTable — both row count and column count are driven at runtime.

The key constraint is Zig's comptime generics: Table(N) requires N to be a compile-time constant. If the column count comes from runtime data (e.g. parsing a CSV header), RuntimeTable is the only option.

csv

Sun, 22 Mar 2026 16:20:00 +0800

csv parses CSV-style delimited text into rows and fields.

With the default comma delimiter, parseDocument() implements RFC 4180 record and quoted-field parsing, including embedded CRLF, doubled-quote escaping, consistent field counts, and explicit parse errors for malformed input.

It also supports a few explicit extensions: alternate delimiters, optional empty-line skipping, and LF-only line endings.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


const std = @import("std");
const zigcli = @import("zigcli");
const csv = zigcli.csv;

const allocator = std.heap.page_allocator;
const input =
 "name,age,city\r\n" ++
 "alice,30,beijing\r\n" ++
 "bob,25,\"new york\"\r\n";

var document = try csv.parseDocument(allocator, input, .{
 .delimiter = ',',
});
defer document.deinit(allocator);

for (document.rows) |row| {
 std.debug.print("{s}\n", .{row[0]});
}

API

`parseLine(allocator, line, delimiter)`

Parse one line and return a newly allocated slice of fields.

`parseDocument(allocator, input, options)`

Parse a whole input buffer and return a Document:

rows: parsed rows
num_cols: column count inferred from the first parsed row

Malformed input returns a parse error such as error.InvalidQuotedField, error.InvalidRecordTerminator, error.InconsistentFieldCount, or error.UnclosedQuotedField.

Document owns the row and field storage. Call document.deinit(allocator) when you are done with it.

gitignore

Fri, 20 Mar 2026 08:45:00 +0800

Features

Full .gitignore spec support: *, ?, [abc], **/, negation (!)
Recursive .gitignore filtering via GitignoreStack (per-directory layers)
Pure Zig implementation — no libc fnmatch dependency
Last-match-wins semantics across all layers

API

`Gitignore`

Parse a single .gitignore file and match paths against it.

1
2
3
4
5
6
7
8
9


const zigcli = @import("zigcli");
const gitignore = zigcli.gitignore;

var gi = try gitignore.Gitignore.init(allocator, content);
defer gi.deinit();

if (gi.shouldIgnore("build/output.o", false)) {
 // path is ignored
}

`GitignoreStack`

Manage a stack of .gitignore layers for recursive directory walks. Each layer is anchored to its directory, and patterns are evaluated with correct relative paths.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


const zigcli = @import("zigcli");
const gitignore = zigcli.gitignore;

var stack = gitignore.GitignoreStack.init();
defer stack.deinit(allocator);

// Push a layer when entering a directory.
const pushed = try stack.tryPushDir(dir, rel_dir, allocator);

if (stack.shouldIgnore(rel_path, is_dir)) {
 // path is ignored
}

// Pop when leaving the directory.
if (pushed) stack.pop(allocator);

Roadmap

Mon, 01 Jan 0001 00:00:00 +0000

zigcli already has two complementary kinds of value:

as a set of reusable Zig packages for building CLI tools
as a collection of standalone command-line programs that users can install directly

The next phase should prioritize foundational capabilities that can be reused across both sides of the project, instead of only adding more isolated utilities.

P0: Strengthen the CLI foundation

1. Configuration system

Goal: provide a unified configuration layer that merges command-line flags, environment variables, and config files.

term

Sat, 21 Mar 2026 21:05:00 +0800

term provides the small terminal-focused building blocks shared by zigcli packages and programs.

Use it when you want reusable ANSI styling, a shared color type, or lightweight terminal capability checks without pulling table rendering into your own code.

Features

Style.Color defines the standard ANSI foreground/background colors, including bright variants
Style combines bold, italic, foreground color, and background color into one reusable value
isTty(file) reports whether a file is attached to an interactive terminal
terminalWidth(file) returns the terminal width when it can be detected, otherwise null
stdoutWidth() is a convenience wrapper for the common stdout case

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


const std = @import("std");
const zigcli = @import("zigcli");
const term = zigcli.term;

const stdout = std.fs.File.stdout();
var buffer: [1024]u8 = undefined;
var writer = stdout.writer(&buffer);

const style: term.Style = .{
 .bold = true,
 .fg = .bright_green,
};

try style.writeString(&writer.interface, "OK");
try writer.interface.writeByte('\n');
try writer.interface.flush();

`Style.Color`

Style.Color is the shared ANSI color enum used by pretty-table cell styling and by any program that wants plain colored output.

Available colors:

black, red, green, yellow
blue, magenta, cyan, white
bright variants such as bright_red and bright_cyan

Useful helpers:

toEscapeCode(): foreground color escape sequence
toBgEscapeCode(): background color escape sequence
writeString(writer, text): write colored text and reset afterward
reset: the ANSI reset sequence

1

try term.Style.Color.yellow.writeString(&writer.interface, "warning");

progress

Fri, 17 Apr 2026 11:55:10 +0800

progress renders progress bars and spinners to the terminal. It handles ANSI cursor control, terminal width detection, render throttling, and rate/ETA calculation automatically.

Output is hidden when the target file is not a TTY, so piping or redirecting will not produce garbled escape sequences.

Timing uses a monotonic clock (std.time.Timer), so rate and ETA calculations are immune to wall-clock adjustments.

Quick start

Progress bar

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


const std = @import("std");
const zigcli = @import("zigcli");
const progress = zigcli.progress;

var bar = progress.Progress.bar(allocator, .{
 .total = 100,
 .prefix = "download",
 .message = "fetching data",
});
defer bar.deinit();

for (0..100) |_| {
 bar.inc(1);
 try bar.render();
}
try bar.finish();

Output:

download [==========>---------] 55.0% 55/100 27/s ETA 0:01 fetching data

Spinner

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


var spinner = progress.Progress.spinner(allocator, .{
 .prefix = "build",
 .message = "compiling",
});
defer spinner.deinit();

for (0..40) |_| {
 spinner.tick();
 try spinner.render();
}
try spinner.finish();

Output:

build | elapsed 0:05 compiling

pstat

Sat, 18 Jul 2026 10:22:32 +0800

pstat continuously prints process snapshots by default. Use --count 1 to emit a single sample and exit.

cumulative CPU time split into total, user, and system time
resident and virtual memory sizes, in bytes by default
thread counts, page faults, page-ins, and context switches
cumulative process energy consumed

It uses proc_pidinfo(PROC_PIDTASKINFO) for CPU and memory, and proc_pid_rusage(RUSAGE_INFO_V6) for energy counters.

Example

1
2
3


./zig-out/bin/pstat --count 1 12345
./zig-out/bin/pstat --human --count 5 12345
./zig-out/bin/pstat --interval 1 --count 5 12345

Process ID: 12345
Command Line: /usr/bin/python3 script.py --port 8080
CPU(s) USER(s) SYS(s) RSS(bytes) VIRT(bytes) TH FAULTS PAGEINS CSW ENERGY(mJ)
18.764 15.932 2.832 103809024 1930428416 4/12 4248 19 10668 511.200
18.781 15.947 2.834 103809024 1930428416 4/12 4250 19 10692 511.742

Process ID: 12345
Command Line: /usr/bin/python3 script.py --port 8080
CPU(s) USER(s) SYS(s) RSS VIRT TH FAULTS PAGEINS CSW ENERGY(mJ)
18.764 15.932 2.832 99.0MiB 1.8GiB 4/12 4248 19 10668 511.200

Key flags

Flag	Description
`-H, --human`	Format memory sizes with adaptive units
`-i, --interval`	Delay in seconds between successive samples
`-n, --count`	Number of samples to print, `0` means infinite

Metric meanings

Command Line: argv reconstructed from KERN_PROCARGS2 when available; otherwise the executable path is shown.
CPU(s): cumulative CPU time charged to the process since it started.
USER(s): cumulative user-space CPU time charged to the process since it started.
SYS(s): cumulative kernel-space CPU time charged to the process since it started.
RSS: physical memory currently resident for this process; --human switches to adaptive units.
VIRT: total virtual address space reserved by this process; --human switches to adaptive units.
TH: runnable threads versus all task threads, formatted as running/total.
FAULTS: cumulative page faults since the process started.
PAGEINS: cumulative page-ins serviced from storage since the process started.
CSW: cumulative task context switches since the process started.
ENERGY(mJ): cumulative process energy counter from ri_energy_nj, shown in millijoules.

hexdump

Sat, 25 Apr 2026 00:00:00 +0800

hexdump prints a color-coded hex dump of files or stdin.

Byte categories colored by semantic meaning: null, whitespace, control chars, printable ASCII, non-ASCII.
Unicode border and separator characters (┌─┬─┐, ┊).
Consecutive identical rows collapsed into a single * line (squeezing).
Reads from a file or stdin.
Auto-disables color when output is not a TTY.

Color scheme

Category	Bytes	Color
Null	`0x00`	bright black
ASCII whitespace	`0x09 0x0A 0x0C 0x0D 0x20`	green
ASCII control chars	`0x01–0x08 0x0B 0x0E–0x1F 0x7F`	green
Printable ASCII	`0x21–0x7E`	cyan
Non-ASCII	`0x80–0xFF`	yellow

Demo

$ echo "Hello, World!" | hexdump --no-color
┌────────┬─────────────────────────┬─────────────────────────┬────────┬────────┐
│00000000│ 48 65 6c 6c 6f 2c 20 57 ┊ 6f 72 6c 64 21 0a │Hello, W┊orld!_ │
└────────┴─────────────────────────┴─────────────────────────┴────────┴────────┘

Options

Flag	Short	Description
`--length`	`-n`	Only read N bytes
`--skip`	`-s`	Skip N bytes from the start
`--color`		When to use colors: `always`, `auto`, `never` (default: `auto`)
`--no-squeezing`		Print all rows, do not collapse repeated rows
`--print-color-table`		Print a color reference table and exit
`--version`	`-v`	Print version
`--help`	`-h`	Print help

Examples

Dump a file

1

hexdump /bin/ls | head -20

Inspect the first 64 bytes

1

hexdump -n 64 file.bin

Skip a header and dump the next 128 bytes

1

hexdump -s 16 -n 128 file.bin

Pipe from another command

1

curl -s https://example.com | hexdump | head -20

pretty-csv

Fri, 20 Mar 2026 10:00:00 +0800

pretty-csv renders CSV (or TSV) files as aligned, bordered tables in the terminal.

Auto-fits table width to the terminal (truncates with …).
Three border styles: ascii, box, dos.
Transpose mode: show each record as a vertical key-value block.
Column selection: display only specific columns.
Optional row separators between data rows.
Right-align selected original columns (useful for numeric CSV fields).
For standard comma-separated CSV input, parsing now fully implements RFC 4180.
Supports quoted fields, including delimiters inside quotes.
Supports embedded CRLF inside quoted fields.
Unescapes doubled quotes in quoted fields.
Rejects malformed quoted fields and rows with inconsistent column counts.

Demo

$ printf 'Name,Age,City\nAlice,30,Beijing\nBob,25,New York\nCharlie,35,London\n' | pretty-csv
┌─────────┬─────┬──────────┐
│ Name │ Age │ City │
├─────────┼─────┼──────────┤
│ Alice │ 30 │ Beijing │
│ Bob │ 25 │ New York │
│ Charlie │ 35 │ London │
└─────────┴─────┴──────────┘

Options

Flag	Short	Description
`--delimiter`	`-d`	Field delimiter (default: `,`)
`--style`	`-s`	Border style: `ascii`, `box`, `dos`
`--padding`	`-p`	Cell padding (default: 1)
`--row-separator`		Insert separator lines between data rows
`--no-header`		Treat first row as data
`--right-columns`	`-r`	Original column indices to right-align (1-based)
`--max-width`	`-w`	Max total table width (0 = auto-fit)
`--transpose`	`-t`	Show each record vertically
`--columns`	`-c`	Column indices to show (1-based)
`--max-size`		Max input file size in MiB (default: 64)

Examples

TSV input

1

printf 'a\tb\n1\t2\n' | pretty-csv -d $'\t'

Select columns

1

pretty-csv -c 1,3,5 data.csv

Right-align numeric columns

1

pretty-csv -r 2,4 ledger.csv

Row separators

1

pretty-csv --row-separator data.csv

Transpose mode

$ printf 'Name,Age,City\nAlice,30,Beijing\nBob,25,New York\n' | pretty-csv -t
┌──────┬─────────┐
│ Name │ Alice │
│ Age │ 30 │
│ City │ Beijing │
└──────┴─────────┘

┌──────┬──────────┐
│ Name │ Bob │
│ Age │ 25 │
│ City │ New York │
└──────┴──────────┘

Limit table width

1

pretty-csv -w 80 wide-data.csv

zfetch

Mon, 16 Mar 2026 20:30:00 +0800

zfetch (⚡) is a lightweight, high-performance system information fetcher inspired by the fastfetch.

The "z" stands for both Zig (the language it's written in) and zap (⚡ lightning-fast). It aims to be extremely fast by avoiding external process calls and using native C APIs or virtual filesystems instead.

Cross-platform: Supports macOS, Linux, and FreeBSD.
Detailed Memory Info:
- On macOS: Provides breakdown of App Memory, Wired Memory, and Compressed Memory (matching Activity Monitor).
- On Linux: Provides Swap usage details.
- On FreeBSD: Uses sysctl for memory and ACPI for battery status.
Hardware Insights: Displays CPU core distribution (Performance vs. Efficiency cores on Apple Silicon), GPU (macOS), and Page Size.
High Performance: Uses sysctl, IOKit, CoreFoundation on macOS, procfs, sysfs on Linux, and sysctl on FreeBSD.

Demo

macOS

 ..' jiacai@mario
 ,xNMM. ────────────
 .OMMMMo OS macOS 26.3 aarch64
 lMM" Host Mac14,10
 .;loddo:. .olloddol;. Kernel 25.3.0
 cKMMMMMMMMMMNWMMMMMMMMMM0: Uptime 20 days, 11 hours, 6 mins
 .KMMMMMMMMMMMMMMMMMMMMMMMWd. Shell bash
 XMMMMMMMMMMMMMMMMMMMMMMMX. Terminal ghostty
;MMMMMMMMMMMMMMMMMMMMMMMM: Resolution 1728x1117 @ 120Hz
:MMMMMMMMMMMMMMMMMMMMMMMM: Theme Light
.MMMMMMMMMMMMMMMMMMMMMMMMX. CPU Apple M2 Pro (12 cores: 8P + 4E)
 kMMMMMMMMMMMMMMMMMMMMMMMMWd. Memory 24.6 GiB / 32.0 GiB (77%) [App: 14.8 GiB, Wired: 3.5 GiB, Compressed: 6.2 GiB]
 'XMMMMMMMMMMMMMMMMMMMMMMMMMMk Disk /: 827 GiB / 926 GiB (89%)
 'XMMMMMMMMMMMMMMMMMMMMMMMMK. Battery 80% [Discharging]
 kMMMMMMMMMMMMMMMMMMMMMMd Page 16 KiB
 ;KMMMMMMMWXXWMMMMMMMk. Local IP 10.192.157.86 (en0), 100.80.224.100 (utun0)
 "cooc*" "*coo'"

Linux

 _nnnn_ jiacai@ThinkCentre-M760t
 dGGGGMMb ───────────────────────
 @p~qp~~qMb OS Ubuntu 24.04.3 LTS x86_64
 M|@||@) M| Host LENOVO 12USCTO1WW
 @,----.JM| Kernel 6.11.0-29-generic
 JS^\__/ qKL Uptime 2 hours, 52 mins
 dZP qKRb Shell bash
 dZP qKKb Terminal tmux
 fZP SMMb Resolution 2560x1440
 HZM MMMM Theme Light
 FqM MMMM CPU 13th Gen Intel(R) Core(TM) i7-13700 (24 logical, 16 physical cores)
 __| ". |\dS"qML Memory 2.9 GiB / 30.9 GiB (9%) [Swap: 0 MiB / 59.6 GiB]
 | `. | `' \Zq Disk /: 547 GiB / 878 GiB (62%)
_) \.___.,| .' Battery No Battery
\____ )MMMMMP| .' Page 4 KiB
 `-' `--' Local IP 10.192.32.23 (eno1), 172.17.0.1 (docker0)

FreeBSD

 ``` ` root@freebsd
 ` `.....---.......--.``` -/ ────────────
 +o .--` /y:` +. OS FreeBSD 15.0-RELEASE x86_64
 yo`:. :o `+- Host FreeBSD
 y/ -/` -o/ Kernel 15.0-RELEASE
 .- ::/sy+:. Uptime 27 mins, 15 secs
 / `-- / Shell sh
 `: :` Terminal vt100
 `: :` Resolution Unknown
 / / Theme Light
 .- -. CPU QEMU Virtual CPU version 2.5+ (2 cores)
 -- -. Memory 171 MiB / 1.9 GiB (8%)
 `:` `:` Disk /: 2 GiB / 4 GiB (67%)
 .-- `--. Battery No Battery
 .---.....----. Page 4 KiB
 Local IP 10.0.2.15 (vtnet0)

progress-it

Mon, 16 Mar 2026 14:00:00 +0800

A port of Xfennec/progress to Zig.

Monitors running processes and displays the percentage, throughput, and ETA for ongoing file operations such as cp, mv, dd, tar, cat, rsync, etc.

Supports Linux (via /proc) and macOS (via libproc).

Example output

[24185] cp /home/user/bigfile.iso
 73.5% (7.4 GiB / 10.0 GiB) [284.5 MiB/s] ETA 0:09

Key flags

Flag	Description
`-m`	Loop while monitored processes are running
`-p <pids>`	Monitor specific PIDs (comma-separated)
`-c <cmds>`	Monitor specific command names
`-w`	Wait for a matching process to appear
`-W <secs>`	Set wait timeout in seconds
`-q`	Quiet mode — percentages only
`-n`	Disable ANSI color output

cowsay

Mon, 16 Mar 2026 04:25:00 +0800

 USAGE:
 ./zig-out/bin/cowsay [OPTIONS] [--] [message]

 OPTIONS:
 -f, --face STRING Which cow face to use (cow, tux). Default: cow.(valid: cow|tux)(default: cow)
 -v, --version Print version.
 -h, --help Print help information.

Demo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


$ cowsay hi
 ____
< hi >
 ----
 \  ^__^
 \  (oo)\_______
 (__)\  )\/\
 ||----w |
 || ||

$ cowsay -f tux hi
 ____
< hi >
 ----
 \
 \
 .--.
 |o_o |
 |:_/ |
 // \ \
 (| | )
 /'\_ _/`\
 \___)=(___/

$ cowsay hello world
 ___________
< hello world >
 -----------
 \  ^__^
 \  (oo)\_______
 (__)\  )\/\
 ||----w |
 || ||

timeout

Thu, 23 Jan 2025 22:28:53 +0800

timeout SECONDS COMMAND [ARG]...

Start a command, and kill it if the specified timeout expires.

The timeout command is crucial for:

Process Control
Limits execution time of commands
Prevents resource-consuming tasks from running indefinitely
Provides automatic process termination

zigfetch

Wed, 01 Jan 2025 18:01:47 +0800

Note: zigfetch has been removed starting with Zig 0.17.0. Please use zig-maker as its replacement. If you are still using Zig 0.16, v0.6.3 is the last version that includes zigfetch.

zigfetch behaves similarly to zig fetch, but utilizing the capabilities of libcurl for its functionality.

HTTP support within Zig's standard library isn't currently stable, this proxy issue make it even harder, resulting in multiple errors occurring during dependency downloads when building Zig projects. This poses a significant challenge for Chinese developers owing to the Great Firewall.

tcp-proxy

Sun, 01 Sep 2024 00:02:43 +0800

Both IPv4 and IPv6 are supported. On Linux splice is used to improve perf, details can be found here.

 USAGE:
 ./zig-out/bin/tcp-proxy [OPTIONS]

 OPTIONS:
 -b, --bind_host STRING Local bind host(default: 0.0.0.0)
 -p, --local_port INTEGER Local bind port(default: 8081)
 -H, --remote_host STRING Remote host(required)
 -P, --remote_port INTEGER Remote port(required)
 --buf_size INTEGER Buffer size for tcp read/write(default: 16384)
 --server_threads INTEGER Server worker threads num(default: 24)
 -h, --help
 -v, --version
 --verbose

1

tcp-proxy -b 0.0.0.0 -p 8082 -H 192.168.0.2 -P 8082

This will forward tcp requests from localhost:8082 to 192.168.0.2:8082

loc

Sat, 17 Aug 2024 17:52:51 +0800

1

./zig-out/bin/loc

┌───────────┬───────┬────────┬───────┬──────────┬────────┬──────────┐
│Language │File │Line │Code │Comment │Blank │Size │
├───────────┼───────┼────────┼───────┼──────────┼────────┼──────────┤
│Zig │363 │10808 │9369 │1050 │389 │632.19K │
│YAML │8 │317 │292 │4 │21 │7.84K │
│TOML │1 │32 │27 │0 │5 │698.00B │
│Makefile │1 │23 │16 │0 │7 │365.00B │
│Python │1 │10 │7 │2 │1 │166.00B │
│C │1 │9 │2 │4 │3 │34.00B │
│Ruby │1 │8 │5 │2 │1 │201.00B │
│Markdown │1 │5 │5 │0 │0 │102.00B │
│CHeader │1 │2 │2 │0 │0 │44.00B │
│JSON │2 │2 │2 │0 │0 │247.00B │
├───────────┼───────┼────────┼───────┼──────────┼────────┼──────────┤
│Total │380 │11216 │9727 │1062 │427 │641.84K │
└───────────┴───────┴────────┴───────┴──────────┴────────┴──────────┘

pidof

Sat, 17 Aug 2024 17:52:44 +0800

Program name is case insensitive by default, pass -S option if you want sensitive match.

 USAGE:
 ./zig-out/bin/pidof [OPTIONS] [--] [program]

 OPTIONS:
 -s, --single Only return the first matching pid.
 -d, --delimiter STRING Delimiter used if more than one PID is shown.(default: )
 -S, --strict Case sensitive when matching program name.
 -u, --user_only Only show process belonging to current user.
 -v, --version Print version.
 -h, --help Print help message.

repeat

Sat, 17 Aug 2024 17:52:32 +0800

 USAGE:
 ./zig-out/bin/repeat [OPTIONS] [--] command

 OPTIONS:
 -m, --max INTEGER Max times to repeat
 -i, --interval INTEGER Pause interval(in seconds) between repeats
 -v, --version Print version
 -h, --help Print help information

tree

Sat, 17 Aug 2024 17:52:22 +0800

 USAGE:
 ./zig-out/bin/tree [OPTIONS] [--] [directory]

 OPTIONS:
 -m, --mode STRING Line drawing characters. (valid: ascii|box|dos)(default: box)
 -a, --all All files are printed.
 -s, --size Print the size of each file in bytes along with the name.
 -d, --directory List directories only.
 -L, --level INTEGER Max display depth of the directory tree.
 -v, --version Print version.
 -h, --help Print help information.

Demo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


$ ./zig-out/bin/tree src
src
├──bin
│ ├──loc.zig
│ ├──night-shift.zig
│ ├──pidof.zig
│ ├──repeat.zig
│ ├──tree.zig
│ ├──util.zig
│ └──yes.zig
└──mod
 ├──pretty-table.zig
 └──structargs.zig

1 directories, 4 files

night-shift

Sat, 17 Aug 2024 17:52:12 +0800

 USAGE:
 ./zig-out/bin/night-shift [OPTIONS] [--] <command>

 Available commands by category:
 Manual on/off control:
 status View current Night Shift status
 on Turn Night Shift on
 off Turn Night Shift off
 toggle Toggle Night Shift

 Color temperature:
 temp View temperature preference
 temp <0-100> Set temperature preference

 Schedule:
 schedule View current schedule
 schedule sun Start schedule from sunset to sunrise
 schedule off Stop the current schedule
 schedule <from> <to> Start a custom schedule(HH:mm, 24-hour format)

 OPTIONS:
	-v, --version Print version
	-h, --help Print help information

Acknowledgment

https://github.com/smudge/nightlight

dark-mode

Sat, 17 Aug 2024 17:52:00 +0800

 USAGE:
 ./zig-out/bin/dark-mode [OPTIONS] [--] <command>

 Available commands:
 status View dark mode status
 on Turn dark mode on
 off Turn dark mode off
 toggle Toggle dark mode

 OPTIONS:
	-v, --version Print version
	-h, --help Print help information