# tokenchronicle

tokenchronicle stores your work history in a local archive so you can search past sessions, track token usage, and resume interrupted work without rerunning costly prompts.

- plugin · `type=plugin` · Claude Code, Codex · ★ 1596 repo stars
- Author: Xin He
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/HuaHuiJian/tokenchronicle-marketplace
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 1 script file) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/tokenchronicle

## What it does

TokenChronicle builds a private session journal directly on your machine. Every interaction in Claude Code gets logged automatically, letting you search old conversations, see how many tokens each project consumed, and pick up where you left off. The archive lives locally—nothing leaves your disk.

This matters when you need to audit token spending across projects, revisit a solution you tried weeks ago, or understand how your coding approach evolved. The local-first design means you can search your entire work history without hitting API costs again.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
In the agent chat (not a shell):
```text
/plugin install tokenchronicle@awesome-codex-plugins
```

## When to use it
- search past coding sessions by keyword or date
- track total token consumption per project
- resume interrupted work from saved session context
- maintain a private audit log of all work without cloud storage
- analyze patterns in how your code solutions evolve

## Example prompts
- Show me my work sessions from the last month
- Find sessions where we discussed error handling
- What's the total token count for this project

## Similar
- [claude-context-monitor](https://affpapa.org/en/nevibecode/plugins/claude-context-monitor.md) — plugin · ★ 23 repo stars
- [origin](https://affpapa.org/en/nevibecode/plugins/qi-xuan-lu-origin.md) — plugin · ★ 3785 repo stars
- [docket](https://affpapa.org/en/nevibecode/mcp/docket.md) — MCP server · ★ 10 repo stars
- [stellavault](https://affpapa.org/en/nevibecode/mcp/stellavault.md) — MCP server · ★ 7 repo stars
- [mindmap-mcp-server](https://affpapa.org/en/nevibecode/mcp/mindmap-mcp-server.md) — MCP server · ★ 6 repo stars
- [Magnemo](https://affpapa.org/en/nevibecode/mcp/magnemo.md) — MCP server · ★ 4 repo stars

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
