CLI Reference

Configuration

Reference for AntelopeJS CLI configuration commands — view, set, and reset global settings.

Overview

The ajs config command group manages global CLI settings. These settings persist across all projects and are stored in a platform-specific configuration file.

Configuration File Location

PlatformPath
Linux / macOS~/.antelopejs/config.json
Windows%USERPROFILE%\.antelopejs\config.json
Use the ajs config commands to manage this file. Editing the file by hand is possible but not recommended.

Configuration Keys

The CLI currently supports one configuration key:

KeyDescriptionDefault
gitURL of the interface repository used by modules installAntelopeJS default repository

The git key controls which repository the CLI queries when running ajs project modules install to resolve unresolved interface imports. Changing this value lets you point the CLI at a private or organization-specific interface repository.

ajs config show

Display all current CLI settings.

ajs config show

This command prints every stored key-value pair. The output is useful for confirming the active configuration before running other commands.

ajs config get

Retrieve the value of a specific configuration key.

ajs config get <key>
ArgumentDescription
keyThe configuration key to read (e.g., git)

Example:

ajs config get git

ajs config set

Set a configuration key to a new value.

ajs config set <key> <value>
ArgumentDescription
keyThe configuration key to update
valueThe new value to assign

Example:

ajs config set git https://github.com/your-org/interfaces.git

After running this command, the CLI uses the specified repository URL whenever ajs project modules install needs to resolve interface dependencies. The new value persists in the configuration file until changed or reset.

ajs config reset

Reset all CLI settings to their default values.

ajs config reset [options]
OptionDescription
-y, --yesSkip the confirmation prompt

Examples:

# Reset with confirmation prompt
ajs config reset

# Reset without confirmation
ajs config reset --yes
Resetting the configuration removes all custom settings. Any custom interface repository URL reverts to the default AntelopeJS repository.

See also