Agora CLI

agoraio-cli is the npm package for the Agora CLI.

Install

npm install -g agoraio-cli

The installed command is agora.

Migration

The old package agora-cli-preview is deprecated. Migrate to:

npm uninstall -g agora-cli-preview
npm install -g agoraio-cli

Usage

agora login
agora whoami
agora project create my-agent-demo --feature rtc --feature convoai
agora project env
eval "$(agora project env --shell)"
agora project env write apps/web/.env.local
agora project doctor

Command Groups

• agora auth ...
• agora project ...
• agora project feature ...
• agora project doctor

agora project env exports the current project's development environment in dotenv, shell, or raw JSON form. By default it prints non-sensitive dotenv lines to stdout; add --with-secrets only when you explicitly need sensitive values such as the app certificate.

Config

The CLI stores config, session, and current-project context under the Agora CLI config directory.

• macOS default: ~/.agora-cli
• Linux default: $XDG_CONFIG_HOME/agora-cli or ~/.config/agora-cli
• Override for local testing: AGORA_HOME=/custom/path

You can inspect the example config in config.example.json.