Environment variables
Environment variables
Section titled “Environment variables”Agents Pack uses a small set of environment variables for the public installer and for optional registry overrides. Day-to-day commands do not require them.
See Install the CLI for the normal install flow.
Installer variables
Section titled “Installer variables”These apply when you run the public installer script.
AGENTS_PACK_INSTALL_DIR
Section titled “AGENTS_PACK_INSTALL_DIR”Absolute destination directory for the agents-pack executable. Default is ~/.local/bin.
AGENTS_PACK_INSTALL_DIR=/absolute/path/to/bin \ sh -c "$(curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh)"If HOME is unset, the installer requires AGENTS_PACK_INSTALL_DIR.
AGENTS_PACK_VERSION
Section titled “AGENTS_PACK_VERSION”Install or reinstall an exact published CLI version instead of the registry’s current latest.
AGENTS_PACK_VERSION=0.1.0 \ sh -c "$(curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh)"When unset, the installer reads the CLI registry and uses its latest field.
AGENTS_PACK_REGISTRY_URL
Section titled “AGENTS_PACK_REGISTRY_URL”Point the installer at a different CLI registry document. Primarily for tests or private deployments.
Default:
https://farfarawaylabs.github.io/agentspackai/registry/v1/cli.jsonAGENTS_PACK_DOWNLOAD_BASE_URL
Section titled “AGENTS_PACK_DOWNLOAD_BASE_URL”Point the installer at a different release download base URL (the version and platform archive name are appended). Primarily for tests or private deployments.
Default:
https://github.com/farfarawaylabs/agentspackai/releases/download/cli-vCLI runtime variable
Section titled “CLI runtime variable”AGENTS_PACK_REGISTRY_URL
Section titled “AGENTS_PACK_REGISTRY_URL”When running the CLI (not only the installer), this overrides the compiled official content-pack registry URL used by init and update for official installations.
Default:
https://farfarawaylabs.github.io/agentspackai/registry/v1/index.jsonUseful for local registry testing. Official installations that already use a local pack via --pack do not consult this registry for updates; they require another explicit --pack candidate.
What these do not control
Section titled “What these do not control”| Concern | How to control it |
|---|---|
| Content-pack version in a project | agents-pack update, pin, rollback |
| Local / air-gapped pack source | --pack <path> on init and update |
| Install scope (repository vs global) | --scope on init |
| Removing managed project content | agents-pack eject |
CLI application versions and content-pack versions are independent. Reinstalling the CLI does not change initialized pack content.