← Back to Skills Marketplace
bshandley

AI Usage

by bshandley · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
719
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install ai-usage
Description
Check AI token usage, quotas, and costs across Anthropic and other providers using Anthropic OAuth API and OpenClaw session logs.
README (SKILL.md)

AI Usage Check

Quick Start

python3 scripts/usage_check.py           # Pretty report with gauges
python3 scripts/usage_check.py --json    # JSON output for scripting

Requirements

  • Python 3.10+ (no pip dependencies — stdlib only)
  • Claude Code installed and authenticated (claude CLI in PATH) — for Anthropic quota
  • OpenClaw installed — for session log token/cost stats

What It Shows

Anthropic (real quota from OAuth API):

  • Weekly utilization % with reset countdown
  • 5-hour rolling window %
  • Model-specific weekly (Sonnet, Opus) when available
  • Extra usage spend vs monthly limit

Other Providers (from OpenClaw session logs):

  • Token counts and call counts per model
  • Auto-detects any provider OpenClaw routes through (Ollama, OpenAI, etc.)

OpenClaw Anthropic breakdown:

  • Per-model token counts and equivalent API cost

How It Works

  • Anthropic quota: GET https://api.anthropic.com/api/oauth/usage using Claude Code's OAuth token from ~/.claude/.credentials.json (requires user:profile scope)
  • Token auto-refresh: If the token is expired, the script automatically refreshes it by invoking claude --print -p "ok" (Claude Code refreshes its own OAuth token on any invocation), then re-reads the updated credentials file. If Claude Code isn't installed, Anthropic quota is skipped gracefully.
  • Session stats: Parses ~/.openclaw/agents/main/sessions/*.jsonl for per-provider/model token and cost data

Environment Variables

Variable Default Description
OPENCLAW_SESSIONS_DIR ~/.openclaw/agents/main/sessions OpenClaw session log directory
CLAUDE_CREDENTIALS_PATH ~/.claude/.credentials.json Claude Code credentials file

Tips

  • Run via Haiku or a lightweight model for heartbeat/background checks — the script just needs to execute, no reasoning required
  • Use --json for programmatic consumption (cron jobs, dashboards, alerts)
  • Works with any Anthropic subscription tier (Pro, Max, Team, etc.)
Usage Guidance
This skill appears to do what it says: it reads OpenClaw session logs and your local Claude credentials to call Anthropic's OAuth usage endpoint. Before installing, review the included script yourself (it is present and readable) and confirm you trust the skill source. Note that it will read ~/.claude/.credentials.json (or the path set by CLAUDE_CREDENTIALS_PATH) and may invoke the local 'claude' CLI to refresh tokens; these actions are required to obtain accurate quota data but expose local credentials to the skill code. If you are uncomfortable, run the script manually in a restricted environment or inspect/modify it to remove any behavior you don't want (for example, printing or transmitting tokens). Also consider that the registry metadata omits the optional env var overrides documented in SKILL.md — expect to set those if your paths differ.
Capability Analysis
Type: OpenClaw Skill Name: ai-usage Version: 1.0.0 The skill is designed to check AI usage across Anthropic and other providers. It legitimately accesses `~/.claude/.credentials.json` to retrieve OAuth tokens for Anthropic API calls and executes the `claude` CLI tool to refresh these tokens. It also parses local OpenClaw session logs for usage statistics. All file access, external command execution, and network requests are directly aligned with its stated purpose and target official endpoints or local files. There is no evidence of data exfiltration, arbitrary command injection, persistence mechanisms, or prompt injection attempts against the agent.
Capability Assessment
✓ Purpose & Capability
The skill claims to report Anthropic quotas and OpenClaw-derived token/cost stats and its code reads ~/.openclaw session logs and the Claude credentials file and calls the Anthropic OAuth usage endpoint — these capabilities align with the stated purpose.
ℹ Instruction Scope
SKILL.md and the script instruct the agent to read OpenClaw session JSONL files and the Claude credentials file and to invoke the local 'claude' CLI to trigger an OAuth refresh. This is within the expected scope for retrieving usage/quota, but it does mean the skill reads a local credentials file and executes a local CLI.
✓ Install Mechanism
No remote install/downloads or package installs are specified. The skill is instruction-only with an included Python script (no external network fetches for code), which minimizes installation risk.
ℹ Credentials
The script accesses the Claude credentials file and the OpenClaw sessions directory (both justified by the stated purpose). Minor metadata mismatch: registry lists no required env vars/primary credential, but SKILL.md documents optional overrides (OPENCLAW_SESSIONS_DIR and CLAUDE_CREDENTIALS_PATH).
✓ Persistence & Privilege
The skill is not marked always:true, requests no elevated platform privileges, does not modify other skills, and only reads local logs/credentials and invokes a local CLI — no persistent/privileged behavior detected.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ai-usage
  3. After installation, invoke the skill by name or use /ai-usage
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Anthropic quota via OAuth with auto token refresh, OpenClaw session log stats, pretty gauges + JSON output
Metadata
Slug ai-usage
Version 1.0.0
License —
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is AI Usage?

Check AI token usage, quotas, and costs across Anthropic and other providers using Anthropic OAuth API and OpenClaw session logs. It is an AI Agent Skill for Claude Code / OpenClaw, with 719 downloads so far.

How do I install AI Usage?

Run "/install ai-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AI Usage free?

Yes, AI Usage is completely free (open-source). You can download, install and use it at no cost.

Which platforms does AI Usage support?

AI Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created AI Usage?

It is built and maintained by bshandley (@bshandley); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments