apfeller

Install apfeller

apfeller installs the manager first, then lets you browse the catalog and install only the apps you want.

curl -fsSL https://raw.githubusercontent.com/hasit/apfeller/main/install.sh | sh

Before You Start

  • apfeller is for macOS.
  • Fish and zsh get automatic shell integration.
  • Some apps require extra commands such as apfel. Check the requirements for each app on the Catalog page.

First Five Minutes

Verify that the manager is available:

apfeller --version

Run a quick health check:

apfeller doctor

Browse the catalog:

apfeller list

Install your first app:

apfeller install <app>

What the Installer Does

  • Downloads the latest apfeller.tar.gz release asset.
  • Installs apfeller into ~/.local/bin.
  • Installs manager completions.
  • Writes Fish or zsh shell setup for the detected shell.
  • If the shell cannot be detected, installs the binary anyway and prints one manual PATH command instead of guessing.

Installed Locations

  • ~/.local/bin/apfeller
  • ~/.config/apfeller/init.zsh
  • ~/.config/apfeller/completions/zsh/
  • ~/.config/fish/conf.d/apfeller.fish
  • ~/.config/fish/completions/
  • ~/.local/share/apfeller/store/<app>/<revision>/
  • ~/.local/share/apfeller/state.tsv

Advanced

By default apfeller reads its app catalog from:

https://raw.githubusercontent.com/hasit/apfeller-apps/main/catalog/latest.tsv

If you need to point at a different catalog, set APFELLER_CATALOG_URL before running apfeller.

APFELLER_CATALOG_URL="file://$PWD/dist/apfeller-catalog.tsv" apfeller list

That is useful when you are testing a local catalog or a locally packaged app bundle.

Guides