agentquota

Local CLI for AgentQuota. It scans supported AI coding-tool usage on your machine, converts it into normalized metadata events, and syncs those events to an AgentQuota hub.

Install

npm install -g agentquota

Requires Node.js 20 or newer.

The package installs two binaries:

• aq
• agentquota

Both binaries run the same CLI.

Quick Start

aq init
aq doctor
aq scan --provider all --json
aq watch --once
aq sync

Scheduled Monitoring

Use install-monitor to configure recurring sync on the current machine:

aq install-monitor \
  --api-url https://your-agentquota-hub.example \
  --token <hub-auth-token>

By default, the scheduled monitor runs every 30 minutes.

aq install-monitor \
  --api-url https://your-agentquota-hub.example \
  --token <hub-auth-token> \
  --interval-minutes 15

Supported schedulers:

• macOS LaunchAgent
• Windows Task Scheduler

Commands

| Command | Description | | --- | --- | | aq init | Create local AgentQuota configuration. | | aq doctor | Check local tool availability and configuration. | | aq scan | Scan local usage and print or queue normalized events. | | aq watch | Incrementally queue new usage events. | | aq sync | Upload queued events to an AgentQuota hub. | | aq status | Print a local usage summary. | | aq config | Read or update local CLI configuration. | | aq install-monitor | Install scheduled local monitoring. |

Run aq --help or aq <command> --help for full command options.

Local Data

AgentQuota stores local configuration and queued events under ~/.agentquota.

• config.json: CLI configuration
• device.json: generated device metadata
• cache/: queued usage events and scanner state
• logs/: scheduled-monitor logs

Queued events stay local until a sync succeeds.

Data Collected

AgentQuota collects usage metadata, not work content.

Collected examples:

• token counts
• model names
• timestamps
• tool and provider names
• generated device identifiers
• hashed local context identifiers

Not collected:

• prompt text
• source code
• shell command bodies
• raw provider API bodies
• provider account data

Inspect pending payloads before syncing:

aq scan --dry-run --show-payload

License

MIT