Analyzing Agent Usage with arok

Overview

arok is a local-first CLI that captures AI agent usage into a SQLite database. Use this skill to retrieve and reason about token consumption, session histories, and AI resource costs across repos, branches, hosts, and models.

Before running any command, verify arok is available:

arok doctor

If arok is not installed or state_dir shows an error, stop and instruct the user to install: curl -fsSL https://raw.githubusercontent.com/srbouffard/arok/main/install.sh | bash.

Workflow Decision Tree

Determine what the user needs: