Skip to main content

​
CLI Overview

The A24Z CLI is your primary interface for configuring and managing AI coding agent observability.

​
Installation

npm install -g a24z

​
Quick Reference

CommandDescription
a24z loginAuthenticate with A24Z
a24z install [tool]Install observability hooks
a24z statusCheck configuration status
a24z org listList your organizations
a24z org switchSwitch organizations
a24z org currentShow active organization
a24z --helpShow all commands
a24z --versionShow CLI version

​
Command Categories

Authentication

Login and logout commands

Installation

Install tool integrations

Organizations

Manage organizations

Status

Check configuration

Configuration

Configure CLI settings

Help & Support

Get help and troubleshooting

​
Global Options

All commands support these global options: 
--help, -h      Show help for command
--version, -v   Show CLI version
--debug         Enable debug output
--quiet         Suppress output
--config        Use custom config file

​
Common Workflows

​
Initial Setup

# Install CLI
npm install -g a24z

# Authenticate
a24z login

# Install for Claude Code
a24z install claude-code

# Verify
a24z status

​
Daily Usage

# Check status
a24z status

# Use your AI tools normally
# Data is automatically collected

# View on dashboard
# Visit app.a24z.ai

​
Organization Management

# List organizations
a24z org list

# Switch organization
a24z org switch "Acme Corp"

# Verify
a24z org current

​
Exit Codes

The CLI uses standard exit codes:
CodeMeaning
0Success
1General error
2Authentication error
3Configuration error
4Network error
5Installation error

​
Configuration

The CLI stores configuration in ~/.a24z/config.json. See Configuration Guide for details.

​
Debugging

Enable debug mode for troubleshooting: 
export A24Z_DEBUG=true
a24z status
Or use the --debug flag: 
a24z install claude-code --debug

​
Getting Help

​
Built-in Help

# General help
a24z --help

# Command-specific help
a24z install --help
a24z org --help

​
Documentation

​
Support

​
Next Steps

Login Command

Learn about authentication

Install Command

Install tool integrations

Organizations

Manage multiple organizations

Status Command

Check your configuration