Skip to content

v0.1.0

Latest

Choose a tag to compare

@github-actions github-actions released this 13 Jun 15:05
· 1 commit to main since this release
v0.1.0

The first release of archive, a fast, scriptable command-line client for the Internet Archive and the Wayback Machine. One static binary, no runtime dependencies, and every public archive.org API behind a small set of verb-first commands.

Highlights

  • Search the Archive with Lucene queries. The default uses the sortable Advanced Search endpoint; --all switches to the cursor-based Scraping API so you can stream every match into a pipeline. -f '*' returns every indexed field.
  • Items and metadata with item for a friendly summary and metadata for the full JSON document. Nothing is dropped: machine-readable output preserves every field exactly as the Archive returns it.
  • Files and downloads with files to list an item's contents (including media fields like bitrate, length, and track) and download to fetch them, with checksum verification.
  • Wayback Machine with wayback to look up snapshots, list CDX captures, fetch raw archived bytes, and submit a URL to Save Page Now.
  • Account-aware commands for views, tasks, upload, delete, and whoami, using IAS3 credentials you configure once with archive configure.

Output that fits your pipeline

Seven formats: table, json, jsonl, csv, tsv, url, and Go templates. --fields projects any parsed field, falling back into the full underlying record so you are never limited to the curated columns. Custom exit codes (3 for no results, 4 for auth, 5 for not found) make scripting predictable.

Credentials are handled carefully

Secrets are masked to the last four characters in any output, the credentials file is written mode 0600, and credentials are never sent over plain HTTP.

Install

Download a prebuilt archive below, or use a package:

# Debian / Ubuntu
sudo dpkg -i archive_*_linux_amd64.deb

# Fedora / RHEL
sudo rpm -i archive_*_linux_amd64.rpm

# Alpine
sudo apk add --allow-untrusted archive_*_linux_amd64.apk

# Container
docker run --rm ghcr.io/tamnd/archive:0.1.0 --help

Each release ships archives for Linux, macOS, and Windows on amd64 and arm64, Linux packages (deb, rpm, apk), a checksums file, SBOMs, a keyless cosign signature, and a multi-arch container image on GHCR.

Documentation

Full guides and the command reference live at https://archive-cli.tamnd.com.