@tokentop/agent-claude-code

tokentop agent plugin for Claude Code (Anthropic's CLI coding agent). Parses session data, tracks token usage, and provides real-time activity monitoring.

Capabilities

Capability	Status
Session parsing	Yes
Credential reading	No
Real-time tracking	Yes
Multi-provider	No

How It Works

This plugin reads Claude Code's local session files from ~/.claude/projects/ to extract:

• Session metadata (start time, duration, project)
• Token usage per message (input, output, cache read/write)
• Model information per conversation turn
• Real-time file watching for live session updates

Install

This plugin is bundled with tokentop — no separate install needed. If you need it standalone:

bun add @tokentop/agent-claude-code

Requirements

• Claude Code installed (~/.claude directory must exist)
• Bun >= 1.0.0
• @tokentop/plugin-sdk ^1.0.0 (peer dependency)

Permissions

Type	Access	Paths
Filesystem	Read	~/.claude

Development

bun install
bun run build
bun test
bun run typecheck

Contributing

See the Contributing Guide. Issues for this plugin should be filed on the main tokentop repo.

License

MIT