Getting Started

The DataAgent CLI (dataagent) checks cluster health, lists and inspects incidents, and gets an AI-generated root-cause summary — all from your terminal.

1. Install

macOS (Homebrew):

brew install data-agent-co/tap/dataagent

This auto-taps the public data-agent-co/homebrew-tap repo — no separate brew tap step needed.

Linux: Homebrew casks are macOS-only. Download the linux_amd64 or linux_arm64 tarball from the releases page, extract it, and put dataagent on your PATH.

Verify the install:

dataagent version

2. Sign in

dataagent login    # opens your browser to sign in
dataagent whoami    # show the signed-in identity

Most commands are scoped to an organisation. If you belong to more than one, set the one you want to use — later commands reuse it:

dataagent orgs                    # organisations you belong to
dataagent config set-org <slug>   # remember one

Triage flow

dataagent status                  # cluster health + active incidents
dataagent incidents list          # open incidents for the current organisation
dataagent incidents show <id>     # one incident in detail
dataagent why <id>                # AI-generated root-cause summary for an incident
dataagent remediate <id>          # the remediation plan for that incident, if it has one

remediate reads the plan and prints its ordered steps — it runs nothing and touches no cluster. Once you have carried the steps out, record what happened with dataagent remediate report <id>, which needs the Operator role. See the CLI reference for the full flag set.

Every command also takes --output json for scripting, e.g. dataagent status --output json.

Non-interactive use

For CI and automation, mint a long-lived API token instead of signing in interactively:

dataagent tokens create --name ci-deploy --expires-in 30d

The token is printed once — save it. Set it as DATAAGENT_TOKEN and the CLI uses it instead of a browser session:

DATAAGENT_TOKEN=<token> dataagent status

AI assistant integration

A Skill teaches Claude Code or Cursor (2.4+) the dataagent CLI and API, so you can ask about your fleet in plain language instead of looking up flags. It triggers on its own when you ask about orgs, incidents, signals, or metrics, when you ask to fix or roll back a failing workload, or when you ask about minting tokens.

dataagent skill update                                  # Claude Code, personal (all projects)
dataagent skill update --dir .claude/skills/dataagent   # Claude Code, this project only
dataagent skill update --dir .cursor/skills/dataagent   # Cursor (2.4+)

Both tools read the same file, and it keeps itself current: before each use the assistant runs dataagent skill update and reloads the skill if a newer version was installed. See the CLI reference for installing without the CLI.

Upgrading

brew update
brew upgrade --cask dataagent

On Linux, download the newer tarball from the releases page and replace the existing binary.

Next steps

This page covers the commands you need to get going. For the full command list — signals, incident mutations (assign, resolve, dismiss, reopen, enrich), remediation plans and attempt reporting, shell completions, and exit codes — see the CLI reference.