Add fastfetch binary: system information fetcher (#69)

* Initial plan

* Add fastfetch binary: system information fetcher

Co-authored-by: jiacai2050 <3848910+jiacai2050@users.noreply.github.com>

* Use fs.cwd().openFile for absolute paths (Zig 0.15 API)

Co-authored-by: jiacai2050 <3848910+jiacai2050@users.noreply.github.com>

* feat(fastfetch): Show detailed system info for Linux and macOS

Expand fastfetch output with host model, disk usage, display resolution,
battery, and theme. Add cross-platform C imports and correct framework
linking on macOS. Improve CPU, memory, and uptime reporting to show more
details and handle both Linux and macOS OS-specific fields.

This change allows users to quickly view comprehensive hardware and OS
information, motivating the update to facilitate troubleshooting and
system inventory.

* docs(programs): add fastfetch introduction and usage guide

Introduce documentation for fastfetch, including usage examples, key
features, and output demonstration. This provides new and existing users
with a clear overview of fastfetch's capabilities and platform support,
enhancing accessibility and understanding without requiring inspection
of the source code.

* feat(build): extend compile blacklist to include fastfetch

Add "fastfetch" to the build blacklist to prevent compilation on
non-Darwin systems. This change ensures platform-specific targets are
handled consistently and avoids build errors caused by unsupported
executables.

* feat(resolution): Display refresh rate in resolution output

Show monitor refresh rate in resolution info on macOS,
providing users a more accurate overview of display settings.
Improves UX for those needing detailed screen specs.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jiacai2050 <3848910+jiacai2050@users.noreply.github.com>
Co-authored-by: jiacai2050 <dev@liujiacai.net>

Author: Copilot

build.zig

@@ -119,6 +119,7 @@ fn buildBinaries(
         "tcp-proxy",
         "timeout",
         "cowsay",
+        "fastfetch",
         "progress",
     }) |name| {
         try buildBinary(
@@ -200,8 +201,10 @@ fn makeCompileStep(
     const is_darwin = @import("builtin").os.tag == .macos and target.result.os.tag == .macos;
     const is_win = target.result.os.tag == .windows;
     if (!is_darwin) {
-        if (std.mem.eql(u8, name, "night-shift") or std.mem.eql(u8, name, "dark-mode")) {
-            return null;
+        inline for (.{ "night-shift", "dark-mode", "fastfetch" }) |blacklist| {
+            if (std.mem.eql(u8, name, blacklist)) {
+                return null;
+            }
         }
     }
     const exe = b.addExecutable(.{
@@ -244,6 +247,17 @@ fn makeCompileStep(
         } else {
             return null;
         }
+    } else if (std.mem.eql(u8, name, "fastfetch")) {
+        if (is_win) {
+            return null;
+        }
+        // fastfetch uses @cImport which requires linking libc to find headers.
+        exe.linkLibC();
+        if (is_darwin) {
+            exe.linkFramework("CoreGraphics");
+            exe.linkFramework("Foundation");
+            exe.linkFramework("IOKit");
+        }
     } else if (std.mem.eql(u8, name, "progress")) {
         // Linux uses the /proc filesystem; macOS uses libproc.
         if (target.result.os.tag == .linux) {

docs/content/programs/fastfetch.org

@@ -0,0 +1,51 @@
+#+TITLE: fastfetch
+#+DATE: 2026-03-16T20:30:00+0800
+#+TYPE: docs
+#+DESCRIPTION: A high-performance system information fetcher written in Zig
+
+#+begin_src bash :results verbatim :exports results :wrap example :dir ../../..
+./zig-out/bin/fastfetch -h
+#+end_src
+
+#+RESULTS:
+#+begin_example
+  USAGE:
+     ./zig-out/bin/fastfetch [OPTIONS]
+
+ OPTIONS:
+  -h, --help                       Print help information.
+  -v, --version                    Print version.
+#+end_example
+
+** Features
+=fastfetch= is a lightweight, high-performance system information fetcher inspired by the original =fastfetch=. It aims to be extremely fast by avoiding external process calls and using native C APIs or virtual filesystems instead.
+
+- **Cross-platform**: Supports both macOS and Linux.
+- **Detailed Memory Info**:
+  - On macOS: Provides breakdown of App Memory, Wired Memory, and Compressed Memory (matching Activity Monitor).
+  - On Linux: Provides Swap usage details.
+- **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 and =procfs=, =sysfs= on Linux.
+
+** Demo
+#+begin_src bash :results verbatim :exports results :wrap example :dir ../../..
+./zig-out/bin/fastfetch
+#+end_src
+
+#+RESULTS:
+#+begin_example
+jiacai@mario
+────────────
+OS:          macOS 26.3 aarch64
+Host:        Mac14,10
+Kernel:      25.3.0
+Uptime:      18 days, 12 hours, 15 mins
+Shell:       bash
+Resolution:  1728x1117 @ 120Hz
+Theme:       Light
+CPU:         Apple M2 Pro (12 cores: 8P + 4E)
+Memory:      25583 MiB / 32768 MiB (78%) [App: 8817 MiB, Wired: 3915 MiB, Compressed: 12851 MiB]
+Disk:        827 GiB / 926 GiB (89%)
+Battery:     80% [Discharging]
+Page:        16 KiB
+#+end_example