Zig CLI for link checking and archiving

Catch broken links. Archive image-heavy sites. Browse everything offline.

argiope is a zero-dependency command-line crawler built for website QA, image downloads, self-contained reports, and portable HTML browsing. It ships as a single binary for Linux, macOS, and Windows.

Install argiope Read the guide Download latest release
Single static binary Text, Markdown, HTML reports Offline browser generation
CI status Release status
argiope check
$ argiope check https://example.com --report report.html --report-format html
Crawling https://example.com (depth=3, timeout=10s)...
404 internal 45 https://example.com/missing-page
timeout external 10001 https://dead-link.example.org/page
Summary:
Total URLs checked: 42
OK: 40
Broken: 1
Errors: 1
Saved self-contained report to ./report.html

Built for practical crawling work

The repo already covers multiple workflows - site validation, image archiving, manga downloads, and offline browsing. The website mirrors that split so new users can quickly pick the right command path.

🔎

Broken-link detection

Crawl same-origin pages, catch 4xx, 5xx, redirects, and timeouts, then turn the results into terminal output or reusable reports.

🧾

Report generation

Write text, Markdown, or self-contained HTML reports, with optional positive results included for audits and CI workflows.

🖼️

Image archiving

Download images into structured folders with configurable crawl depth, delay, timeout, and optional parallel crawling.

📚

Offline HTML browser

Generate `library.html`, nested `index.html`, and `reader.html` pages so downloaded image trees stay easy to explore locally.

🕸️

MangaFox support

Download chapter sets from `fanfox.net`, keep numeric chapter order, and filter ranges with `--chapters N-M`.

⚙️

Zero dependencies

Built with Zig standard library only, released as a single static binary for Linux, macOS, and Windows.

Install it the way your environment expects

The Pages site also hosts the install scripts directly, so you can use clean install URLs instead of raw GitHub file links.

Recommended Hosted on GitHub Pages

One-command install scripts

Use the same scripts tracked in the repository, published at stable Pages endpoints.

Linux / macOS 
curl -fsSL https://christianhelle.com/argiope/install | sh
Windows PowerShell 
irm https://christianhelle.com/argiope/install.ps1 | iex

The scripts detect the platform, download the latest release asset, and install `argiope` to a PATH-friendly location.

📦

Snap Store

sudo snap install argiope

Fastest Linux-native install when snap is already available.

⬇️

GitHub Releases

https://github.com/christianhelle/argiope/releases/latest

Download prebuilt archives for Linux x86_64, Linux aarch64, macOS x86_64, macOS aarch64, and Windows x86_64.

🧱

Build from source

git clone https://github.com/christianhelle/argiope.git
cd argiope
zig build -Doptimize=ReleaseFast

Requires Zig 0.15.2 or later. The binary lands in `zig-out/bin/argiope`.

Quick start

Link checking

Check a site and save an HTML report

argiope check https://example.com
argiope check https://example.com --depth 5 --timeout 15
argiope check https://example.com --report report.html --report-format html

Good fit for docs sites, release checks, and CI jobs where you need a readable artifact at the end.

Image archiving

Download a gallery and browse it locally

argiope images https://example.com/gallery -o ./images
xdg-open ./images/library.html

Every run generates a portable browser with folder landing pages and ordered reader views.

MangaFox

Download a chapter range

argiope images https://fanfox.net/manga/naruto --chapters 1-10 -o ./manga
argiope library ./manga

RSS-driven chapter detection keeps numeric ordering stable, with HTML parsing as fallback.

Portable output: argiope keeps generated browsing pages relative-link friendly, so copied folders still work from local disk, USB storage, or CI artifacts.

Pick the path you need

Install

Installation guide

Shell, PowerShell, Snap, release archives, source builds, and PATH verification.

 Guide

Usage walkthrough

Broken-link checks, image downloads, report mode, offline browser output, and troubleshooting.

 CLI reference

Commands and flags

Exact command list, defaults, examples, report formats, and command behavior.

 Automation

CI/CD examples

Use HTML or Markdown reports inside GitHub Actions and publish them as workflow artifacts.