cli

Axiom unlocks observability at any scale.

• Ingest with ease, store without limits: Axiom's next-generation datastore
  enables ingesting petabytes of data with ultimate efficiency. Ship logs from
  Kubernetes, AWS, Azure, Google Cloud, DigitalOcean, Nomad, and others.
• Query everything, all the time: Whether DevOps, SecOps, or EverythingOps,
  query all your data no matter its age. No provisioning, no moving data from
  cold/archive to "hot", and no worrying about slow queries. All your data, all.
  the. time.
• Powerful dashboards, for continuous observability: Build dashboards to
  collect related queries and present information that's quick and easy to
  digest for you and your team. Dashboards can be kept private or shared with
  others, and are the perfect way to bring together data from different sources.

For more information check out the
official documentation and our
community Discord.

Usage

There are multiple ways you can install the CLI:

• With Homebrew: brew install --cask axiomhq/tap/axiom
• Download the pre-built binary from the
  GitHub Releases
• Using Go: go install github.com/axiomhq/cli/cmd/axiom@latest
• Use the Docker image: docker run axiomhq/cli
• In GitHub Actions: uses: axiomhq/cli/actions/setup@v0.19.0, see
  GitHub Action

Run axiom help to get familiar with the supported commands:

The power of Axiom on the command-line.

USAGE
  axiom <command> <subcommand> [flags]

CORE COMMANDS
  ingest:      Ingest structured data
  query:       Query data using APL

MANAGEMENT COMMANDS
  annotation:  Manage annotations
  auth:        Manage authentication state
  config:      Manage configuration
  dataset:     Manage datasets

ADDITIONAL COMMANDS
  completion:  Generate shell completion scripts
  help:        Help about any command
  version:     Print version
  web:         Open Axiom in the browser

FLAGS
  -O, --auth-org-id string   Organization ID to use
  -T, --auth-token string    Token to use
  -C, --config string        Path to configuration file to use
  -D, --deployment string    Deployment to use
  -h, --help                 Show help for command
      --no-spinner           Disable the activity indicator
  -v, --version              Show axiom version

EXAMPLES
  $ axiom auth login
  $ axiom version
  $ cat http-logs.json | axiom ingest http-logs

AUTHENTICATION
  See 'axiom help credentials' for help and guidance on authentication.

ENVIRONMENT VARIABLES
  See 'axiom help environment' for the list of supported environment variables.

LEARN MORE
  Use 'axiom <command> <subcommand> --help' for more information about a command.
  Read the manual at https://axiom.co/docs/reference/cli

Configuration

The default configuration file is .axiom.toml located in the home directory.
Configuration values can also be set using flags or the environment. Flags get
precedence over environment variables which get precedence over the
configuration file values.

GitHub Action

The actions/setup action installs the CLI on a workflow runner and adds it to
PATH. It installs the latest release by default:

- uses: axiomhq/cli/actions/setup@v0.19.0
  with:
    version: latest # Optional, this is the default.
- run: axiom query "['my-dataset']"
  env:
    AXIOM_TOKEN: ${{ secrets.AXIOM_TOKEN }}

See actions/setup for the full reference.

Claude Code Plugin

This repository includes a Claude Code
plugin for APL query assistance. The plugin provides skills for dataset
exploration, trace analysis, and anomaly detection.

Installation

# Add the Axiom CLI marketplace
claude plugin marketplace add axiomhq/cli

# Install the plugin
claude plugin install axiom-cli@axiomhq-cli

Available Skills

• /explore-dataset <name> - Discover schema, fields, and query patterns
• /find-traces <trace-id> - Analyze OpenTelemetry distributed traces
• /detect-anomalies <dataset> - Statistical anomaly detection

License

Distributed under the MIT License.

{
  "name": "axiom-cli",
  "owner": {
    "name": "Axiom, Inc.",
    "email": "support@axiom.co"
  },
  "metadata": {
    "description": "Axiom CLI plugin marketplace",
    "version": "0.20.0"
  },
  "plugins": [
    {
      "name": "axiom-cli",
      "source": "./",
      "description": "APL query assistance and Axiom CLI skills for Claude Code",
      "version": "0.20.0",
      "author": {
        "name": "Axiom, Inc."
      },
      "homepage": "https://axiom.co/docs/reference/cli",
      "repository": "https://github.com/axiomhq/cli",
      "license": "MIT",
      "keywords": [
        "axiom",
        "observability",
        "apl",
        "logs",
        "traces",
        "metrics"
      ]
    }
  ]
}