apkg update
The update command checks the registry for newer versions of your dependencies and upgrades them. By default it respects the semver ranges in apkg.json (e.g. ^1.2.0). Use --latest to ignore ranges and jump to the absolute latest version.
Synopsis
Section titled “Synopsis”apkg update [<package>] [--latest] [--dry-run] [--setup <tool>] [--no-setup]Options
Section titled “Options”| Option | Description |
|---|---|
--latest | Ignore semver ranges and update to the absolute latest version |
--dry-run | Show what would change without downloading or writing any files |
--setup <tool> | Generate configuration for a specific tool (e.g. claude-code) |
--no-setup | Skip post-install tool setup entirely |
Update all dependencies
Section titled “Update all dependencies”apkg updateResolves every dependency in apkg.json against the registry and upgrades any package that has a newer compatible version available. A summary table is printed showing the current and updated versions.
Update a single package
Section titled “Update a single package”apkg update @acme/code-reviewerOnly updates the specified package. The command fails if the package is not listed in apkg.json.
Semver ranges vs. --latest
Section titled “Semver ranges vs. --latest”Without --latest, the command stays within the caret range recorded in apkg.json. For example, if apkg.json has "^1.2.0", the command will update to the newest 1.x.x release but will not jump to 2.0.0.
With --latest, the command fetches the absolute latest version regardless of the range, and updates the range in apkg.json to match (e.g. ^1.2.0 becomes ^2.1.0).
Dry run
Section titled “Dry run”Use --dry-run to preview changes without modifying any files:
apkg update --dry-runThis prints the changes table and exits. No packages are downloaded, and neither apkg.json nor apkg-lock.json are modified.
Tool setup
Section titled “Tool setup”After updating a skill or agent package, apkg re-runs tool setup and replaces any previously generated configuration files. Use --setup claude-code to target a specific tool, or --no-setup to skip setup entirely. See Tool Setup Explained for details.
Examples
Section titled “Examples”Update all dependencies within their semver ranges:
apkg updateUpdate a single package to the latest compatible version:
apkg update @acme/code-reviewerUpdate everything to the absolute latest, ignoring ranges:
apkg update --latestPreview what would change without modifying anything:
apkg update --dry-runRelated commands
Section titled “Related commands”| Command | Description |
|---|---|
add | Add a new package to dependencies |
install | Install all dependencies from apkg.json |
remove | Remove a package from your dependencies |
config | Set defaultSetup for automatic tool setup |