apkg config

The config command reads and writes persistent CLI settings. Configuration is stored in ~/.apkg/config.json and applies globally to all APKG operations on your machine.

Synopsis

apkg config <subcommand> [arguments]

Subcommands

set

Set a configuration value.

apkg config set <KEY> <VALUE>

The key must be one of the valid configuration keys listed below. If the key already exists, its value is overwritten.

get

Retrieve a single configuration value.

apkg config get <KEY>

Prints the value to stdout. Returns an error if the key is not set.

list

Display all configured values.

apkg config list

Prints every key-value pair currently stored. If no configuration has been set, displays “No configuration set. Using defaults.”

delete

Remove a configuration value.

apkg config delete <KEY>

Returns an error if the key is not set.

Configuration keys

Key	Description	Example value
registry	Package registry URL	https://registry.example.com
services.<name>	Per-service URL override	https://auth.example.com
defaultSetup.<tool>	Enable or disable a tool’s default setup	true or false

registry

Overrides the default registry URL for all commands that talk to the registry (install, publish, search, etc.). This can also be set via the APKG_REGISTRY environment variable.

services.<name>

Overrides the URL for a specific backend service. Valid service names are auth, package, mfa, and search. When a service override is not set, the CLI falls back to the registry URL.

defaultSetup.<tool>

Controls whether a tool’s configuration is set up automatically after installing a package. Valid tools are cursor, claude-code, windsurf, kiro, and codex. Accepts true or false.

Examples

Point to a private registry:

apkg config set registry https://registry.internal.example.com

Check the current registry:

apkg config get registry

Enable Claude Code setup by default after installs:

apkg config set defaultSetup.claude-code true

Override the auth service URL for local development:

apkg config set services.auth http://localhost:8787

View all configuration:

apkg config list

Remove a configuration value:

apkg config delete services.auth