agops-cli

Command-line tool for Ag-Ops — ship Claude Code and Codex CLI session logs to your dashboard so every AI session becomes a readable story.

Install

npm install -g agops-cli

Quickstart

agops login           # opens browser to authenticate
agops watch           # tail ~/.claude/projects/ and ship completed sessions

Or set up a Claude Code hook in ~/.claude/settings.json:

{ "hooks": { "post_session": "agops push --auto" } }

Commands

| Command | Description | | ------------------------------ | ----------------------------------------------------------------------------- | | agops login | Browser-based auth; stores token in ~/.agops/config.json. | | agops watch | Background daemon. Tails Claude Code JSONL logs and ships completed sessions. | | agops watch --project <name> | Override auto-detected project name. | | agops push --auto | One-shot push of the latest session — for use in hooks. | | agops push <file> | Push a specific session file. | | agops status | Connection status, last sync, and queued session count. | | agops logout | Clear credentials. |

Delivery reliability

Failed shipments retry with exponential backoff (3 attempts: 1s, 2s, 4s). On repeated failure, sessions queue to disk at ~/.agops/queue/ and drain on the next successful connection. Use agops status to see the queue depth.

Configuration

Override the backend endpoint via the AGOPS_ENDPOINT environment variable. Defaults to the hosted Ag-Ops backend.

License

MIT