CLI Reference

Introduction

Overview of the AntelopeJS CLI — installation, command structure, global options, and configuration storage.

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

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:

CommandDescription
projectProject management — init, dev, build, start, modules, logging
moduleModule development — scaffold from templates, run tests
configCLI 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:

OptionDescription
-v, --versionDisplay the CLI version number
--verboseEnable verbose logging channels (repeatable for more detail)
--helpShow 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
When you are unsure about a command's syntax, append --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:

PlatformPath
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.