Scriba — Development skill for Claude Code

Scriba

Fast, local-first usage tracking for Claude Code and Codex.

Scriba is a small Go CLI and resident Telegram bot for people who live in agent terminals. It reads local Claude/Codex session logs, checks the ChatGPT/Codex subscription usage backend when your local Codex auth is available, and keeps enough SQLite state to send useful reset and limit notifications without becoming the source of truth.

The macOS menu bar app remains archived in place under `apps/macos`, but it is outside the active product roadmap. The maintained product surfaces are the CLI, resident server, Telegram, Unix HTTP/SSE API, and stdio MCP.

Features

• Local Claude Code and Codex usage reports: daily, weekly, monthly, sessions, and summaries. Codex reports separate effective tokens from full cached traffic, show every materially used model, and estimate standard API cost.
• Live Codex limit windows from the logged-in ChatGPT/Codex backend.
• scriba codex reset-grants for available reset grants and each grant's expiration timestamp.
• scriba codex reset for an explicitly confirmed redemption of the available grant expiring soonest, with a non-mutating --dry-run preview.
• scriba codex profile for ChatGPT/Codex profile token activity, streaks, reasoning mix, and top skills/plugins.
• Explicit additional Codex buckets, including Spark when OpenAI exposes it.
• Resident Telegram bot with /profiles, profile-aware /limits, /grants, confirmed /reset, /profile, plus /refresh, /health, /stats, /lastreset, /settings, and radar commands.
• Telegram notifications for weekly resets, deduplicated pacing risk, low remaining limits, reset-grant expiry checkpoints, service health, and Codex Radar probability milestones.
• Local SQLite cache/state. Source logs and provider APIs remain authoritative.
• JSON-only scriba context --json [--profile ] for an allowlisted, read-only agent view of quota windows, budgets, grants, source freshness, and m