hermes-token-audit

Parse state.db and agent.log to audit local token usage and costs.

1|Updated May 18, 2026
One-click install
npx skills add https://github.com/qiuhaomem/HawkEye-Mem --skill hermes-token-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-token-audit
Source: https://github.com/qiuhaomem/HawkEye-Mem/tree/main/skills/hermes-token-audit
Command: npx skills add https://github.com/qiuhaomem/HawkEye-Mem --skill hermes-token-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Token audit solves the lack of local visibility into token consumption and costs by performing offline, privacy-preserving analysis on HawkEye-Mem data.

Core Features & Use Cases

  • Local audit of state.db and agent.log to compute totals, source distribution, waste, and cron auditing; supports private, on-device analysis for governance and optimization.
  • Outputs structured JSON for AI agents or trend analysis, with zero external dependencies.
  • Use cases include tracking token spend, validating cached vs actual costs, detecting waste patterns, and budgeting insights for scheduling.

Quick Start

Run hawk-eye-mem --token-audit to perform a local token audit.

Frequently Asked Questions about hermes-token-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit local token usage from state.db and agent.log?

To audit local token usage, you can run an offline analysis on state.db and agent.log files. This process parses local data to compute totals, source distribution, and waste patterns without sending any data externally.

What is on-device token auditing and how does it protect privacy?

On-device token auditing parses local memory state files to compute token costs and usage trends locally. It operates entirely offline using Python standard library modules, ensuring data never leaves your machine for privacy-preserving governance.

Can I analyze token waste and costs using only Python standard library?

Yes, you can analyze token waste and costs using only the Python standard library. The audit relies solely on built-in modules like sqlite3, json, datetime, re, and csv, requiring zero external dependencies to parse state data.

How do I get structured JSON output for token cost trend analysis?

To get structured JSON output for token cost trend analysis, run a local token audit on your state data. The audit computes distribution and waste across a defined time window, outputting structured JSON formatted for AI agents.

Does the token audit require external dependencies or send data externally?

No, the token audit requires zero external dependencies and never sends data externally. It uses only the Python standard library to perform on-device analysis, maintaining strict privacy and operating offline.