Skip to content

README.md

Latest commit

 

History

History
62 lines (42 loc) · 2 KB

README.md

File metadata and controls

62 lines (42 loc) · 2 KB

@tokentop/agent-claude-code

npm CI License: MIT

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