amipkg - install, update and remove software on your Amiga
==========================================================

amipkg is a package manager for classic AmigaOS 3.x - think "apt/Homebrew
for your Amiga". It installs, updates and removes software from
a curated catalog of 100+ freely-distributable classics and tools (players,
commodities, internet apps, dev tools, games), resolved and downloaded
straight on your Amiga.

FEATURES

 * Curated, CRYPTOGRAPHICALLY SIGNED catalog: the index is Ed25519-signed
   offline and verified on your Amiga; every download is checked against a
   SHA-256 pinned in that signed catalog. A tampered index or archive is
   refused. No other Amiga tool does this.
 * Dependency resolution: installs what a package needs first, picking the
   right CPU build for your machine (68000..68060 via AttnFlags).
 * Clean removal: a receipt database records every file and boot-script
   change; `amipkg remove` deletes only what it installed and strips its
   User-Startup blocks. `amipkg doctor` audits your installs.
 * Three front-ends, one logic: a fast CLI (list/avail/info/install/
   upgrade/remove/update/doctor, DRYRUN preview), a zero-dependency
   GadTools GUI, and a MUI GUI (3.8+) - browse, search, category filter,
   newest-first, one-click install with live progress, Run and Adopt.
 * Self-updating: `amipkg upgrade amipkg`.
 * Runs on a stock 68000 with AmigaOS 3.0+; guaranteed 128 KB stack via
   StackSwap regardless of your Shell settings.

REQUIREMENTS

 * AmigaOS 3.0+ (GadTools); C:lha (standard on almost every system)
 * A TCP/IP stack with bsdsocket.library for downloads only - Roadshow,
   AmiTCP, Miami, or an emulator's built-in bsdsocket. Browsing the bundled
   catalog works offline.
 * Optional: AmiSSL 5.x enables downloads from https-only hosts (GitHub);
   everything on Aminet works without it.

INSTALL

Extract into a drawer of your choice - amipkg LIVES in that drawer (like
MUI:), with the signed catalog seeded for offline browsing. Double-click
"Install" (self-contained: nothing outside the drawer is ever touched;
uninstall = delete the drawer) or "Install-System" (additionally adds the
AMIPKG: assign + Shell path to S:User-Startup as one marked block).

QUICK START

  amipkg avail mod          ; search the catalog
  amipkg install hippoplayer
  amipkg check              ; anything outdated?
  amipkg upgrade            ; update everything

Package submissions are pull requests (pure Python tooling, no Amiga or Mac
needed) reviewed and signed by a maintainer - Homebrew-style:
https://github.com/thomas-luebker/amiga-pkg

amipkg is part of the Amiga Imager project (https://amiga-imager.com) but
runs on ANY AmigaOS 3.x system - no Amiga Imager required.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]               194896  194896 100.0% -lh0- c5a0 Jul 24 12:00 amipkg
[generic]               171172  171172 100.0% -lh0- af0b Jul 24 12:00 amipkg-gui
[generic]                 1654    1654 100.0% -lh0- d042 Jul 24 12:00 amipkg-gui.info
[generic]               173736  173736 100.0% -lh0- 821f Jul 24 12:00 amipkg-mui
[generic]                 1654    1654 100.0% -lh0- d042 Jul 24 12:00 amipkg-mui.info
[generic]                 7816    7816 100.0% -lh0- 0ea1 Jul 24 12:00 amipkg.guide
[generic]               236845  236845 100.0% -lh0- f28e Jul 24 12:00 packages.json
[generic]                   88      88 100.0% -lh0- 88c9 Jul 24 12:00 packages.json.sig
[generic]                 2905    2905 100.0% -lh0- 40f2 Jul 24 12:00 Install
[generic]                 1664    1664 100.0% -lh0- 228b Jul 24 12:00 Install.info
[generic]                 1843    1843 100.0% -lh0- cb82 Jul 24 12:00 Install-System
[generic]                 1664    1664 100.0% -lh0- 228b Jul 24 12:00 Install-System.info
[generic]                 5723    5723 100.0% -lh0- 943d Jul 24 12:00 ReadMe
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        13 files  801660  801660 100.0%            Jul 27 23:01