pi-axiom

pi extension for querying Axiom logs, monitors, and debugging alerts

Package details

extension

Install pi-axiom from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-axiom

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

A pi extension for querying Axiom logs, monitors, and debugging alerts — all from within your CLI agent.

npm (published package):

pi install npm:pi-axiom

git (from a remote repository):

pi install git:github.com/benclmnt/pi-axiom

local path (development):

pi install /path/to/pi-axiom
# or just for a single session:
pi -e /path/to/pi-axiom

In your Axiom dashboard, go to Settings → API Tokens and create a token with read access for all datasets and monitors.

Run /axiom-config inside pi to paste your token, or set it as an environment variable:

export AXIOM_TOKEN=xaat-...

Optional — custom Axiom deployment URL:

export AXIOM_BASE_URL=https://axiom.yourcompany.com

Then reload with /reload.

Run /axiom-config again to confirm everything is working.

Command	Description
`/axiom-config`	Check status or interactively configure your Axiom API token

Tool	Description
`axiom_list_datasets`	List datasets available to your token
`axiom_query_logs`	Run an APL query against any dataset
`axiom_list_monitors`	List all alert monitors
`axiom_get_monitor`	Inspect a specific monitor's config and query
`axiom_get_monitor_history`	View open/close history for a monitor
`axiom_debug_alert`	Collect monitor config + history + query results in one shot

"List my Axiom datasets."

"Run ['prod-logs'] | where level == 'error' | limit 20 for the last hour."

"List my monitors and inspect the payment-errors monitor."

"Debug why monitor mon_XYZ fired yesterday at 2pm."

MIT