Introduction
Overview
The AntelopeJS CLI (ajs) provides a single command-line interface for every stage of the development lifecycle. You use it to create projects, manage modules, run development servers, produce build artifacts, and configure global settings.
Installation
Install the CLI globally with your preferred package manager:
npm install -g @antelopejs/core
yarn global add @antelopejs/core
pnpm add -g @antelopejs/core
After installation, the ajs command is available in your terminal. Verify it works by checking the version:
ajs --version
Command Structure
Every CLI invocation follows the same pattern:
ajs <command> <subcommand> [arguments] [options]
The CLI organizes its functionality into three top-level commands:
| Command | Description |
|---|---|
project | Project management — init, dev, build, start, modules, logging |
module | Module development — scaffold from templates, run tests |
config | CLI configuration — view and set global settings |
Each top-level command contains subcommands that perform specific tasks. For example, ajs project dev starts the development server, while ajs project modules add installs new modules.
Global Options
These options apply to any command:
| Option | Description |
|---|---|
-v, --version | Display the CLI version number |
--verbose | Enable verbose logging channels (repeatable for more detail) |
--help | Show help for the current command |
The --verbose flag can be repeated to increase the logging detail level. A single --verbose enables standard verbose output; adding more increases granularity.
Getting Help
Every command and subcommand supports the --help flag. Use this flag to see available subcommands, arguments, and options:
# Top-level help
ajs --help
# Help for project commands
ajs project --help
# Help for a specific subcommand
ajs project dev --help
--help to see a usage summary directly in the terminal.Configuration Storage
The CLI stores global settings in a JSON file at a platform-specific location:
| Platform | Path |
|---|---|
| Linux / macOS | ~/.antelopejs/config.json |
| Windows | %USERPROFILE%\.antelopejs\config.json |
This file holds values such as the default interface repository URL. You manage it through the ajs config commands rather than editing it by hand. See the Configuration page for details.