apkg install
The install command downloads and extracts packages into apkg_packages/. When run without arguments it installs every dependency listed in apkg.json. When given a package name it installs that single package.
Packages are cached locally so repeated installs are fast. Every download is verified against its SHA256 integrity hash.
Synopsis
Section titled “Synopsis”apkg install [<package>] [--setup <tool>] [--no-setup] [--frozen-lockfile]Options
Section titled “Options”| Option | Description |
|---|---|
--setup <tool> | Generate configuration for a specific tool (e.g. claude-code) |
--no-setup | Skip post-install tool setup entirely |
--frozen-lockfile | Fail if the lockfile is missing or would change (useful for CI) |
Install all dependencies
Section titled “Install all dependencies”apkg installReads apkg.json, resolves all dependencies, downloads and extracts each package, and writes or updates apkg-lock.json. Tool setup runs for every installed package that supports it.
Install a single package
Section titled “Install a single package”apkg install <package>Works like apkg add for downloading and extracting, but does not add the package to apkg.json dependencies. The lockfile is still updated. The <package> argument supports the same formats as add — @scope/name, @scope/name@version, or @scope/name@tag.
Frozen lockfile
Section titled “Frozen lockfile”The --frozen-lockfile flag is designed for CI environments where you want reproducible installs. It ensures that:
- An
apkg-lock.jsonfile already exists — the command fails if it is missing. - The resolved dependency tree exactly matches the lockfile — the command fails if any package would be added, removed, or changed.
apkg install --frozen-lockfileTool setup
Section titled “Tool setup”After installation, apkg can generate configuration files for AI coding tools. When installing all dependencies, setup runs for every eligible package (types skill and agent). Use --setup claude-code to target a specific tool, or --no-setup to skip setup entirely. See Tool Setup Explained for how detection, precedence, and file generation work.
Examples
Section titled “Examples”Install all dependencies from apkg.json:
apkg installInstall all dependencies in CI with a locked dependency tree:
apkg install --frozen-lockfileInstall a single package by name:
apkg install @acme/code-reviewerInstall all dependencies and set up Claude Code:
apkg install --setup claude-codeRelated commands
Section titled “Related commands”| Command | Description |
|---|---|
add | Add a package to dependencies and install it |
remove | Remove a package from your dependencies |
update | Update packages to latest compatible versions |
config | Set defaultSetup to control automatic tool setup |