# Tools that read your agent session logs - ccusage and alternatives

> ccusage, claude-code-log, claude-code-viewer, Agent Sessions, splitrail and tokscale compared - what each does with your Claude Code and Codex logs, and what it reads.

Source: https://groundedby.com/guides/tools-that-read-agent-session-logs (updated 2026-10-29)

Your agents' logs are plain files, and a small ecosystem of open-source tools reads them. They answer different questions: what did it cost, what happened, what can I search.

## At a glance

| Tool | Answers | Agents | Runs |
| --- | --- | --- | --- |
| ccusage | What did my usage cost? | Claude Code, Codex, OpenCode, Amp, Gemini CLI, Copilot CLI, Goose and more | CLI, local |
| claude-code-log | What happened in my sessions? | Claude Code; Codex in beta | CLI and TUI, local |
| claude-code-viewer | Browse and resume sessions | Claude Code | Local web app |
| Agent Sessions | Search all my agents' sessions | 16 formats incl. Codex, Claude Code, Cursor CLI, Copilot CLI | macOS app, local |
| splitrail | Track tokens and cost over time | Claude Code, Codex, Gemini, Cline, Copilot, OpenCode and more | CLI; optional upload, off by default |
| tokscale | Compare usage with others | About 30 agents | CLI; opt-in public leaderboard |
| groundedby evaluator | What is my history worth? | Claude Code, Codex | Browser, local |

All are MIT licensed except the groundedby evaluator, which runs in your browser on [this site](/evaluate).

## ccusage

The best known of these. ccusage reads Claude Code's `~/.claude/projects` (and `~/.config/claude/projects`), and Codex's `sessions` and `archived_sessions`, compressed files included. It reports token usage and cost by day, week, month, session or five-hour billing block, and can feed a status line.

```bash
npx ccusage@latest daily
npx ccusage@latest codex daily
```

It moved from `ryoppippi/ccusage` to `ccusage/ccusage`, and the separate `@ccusage/codex` package is deprecated in favor of `ccusage codex`.

## claude-code-log

Turns Claude Code JSONL transcripts into readable HTML, Markdown or JSON, with a terminal interface and watch and serve modes. Good for archiving sessions in a form you can read years later.

## claude-code-viewer

A local web app for browsing Claude Code sessions, which can also start and resume them. Point it at another folder with `--claude-dir`.

## Agent Sessions

A macOS app that indexes sessions from many agents in one place, with search and resume. The widest format coverage of the group.

## splitrail and tokscale

Both track tokens and cost across many agents. splitrail can upload to its cloud if you turn that on. tokscale has an opt-in public leaderboard. Read their settings before running either.

## Before you run any of them

These tools read files that contain your code, keys and customers' data. Prefer tools you can read the source of, run them from a pinned version, and check whether anything is sent over the network. [How to redact secrets from agent logs](/guides/redact-secrets-from-agent-logs).

## Questions

**What is ccusage?**

ccusage is an open-source command-line tool that reads your local agent logs and reports token usage and cost by day, week, month, session or five-hour block. It started with Claude Code and now reads Codex, OpenCode, Amp, Gemini CLI, Copilot CLI, Goose and more.

**Do these tools upload my sessions?**

ccusage, claude-code-log, claude-code-viewer and Agent Sessions work locally. splitrail has an optional cloud upload, off by default, and tokscale has an opt-in public leaderboard. Check each tool's settings before you run it.

**Why does ccusage show fewer Claude Code sessions than I expected?**

Claude Code deletes session files older than 30 days by default, and ccusage can only read files that still exist. Raise cleanupPeriodDays in ~/.claude/settings.json to keep more.

## Sources

- [ccusage on GitHub](https://github.com/ccusage/ccusage)
- [claude-code-log on GitHub](https://github.com/daaain/claude-code-log)
- [claude-code-viewer on GitHub](https://github.com/d-kimuson/claude-code-viewer)
- [Agent Sessions on GitHub](https://github.com/jazzyalex/agent-sessions)
- [splitrail on GitHub](https://github.com/Piebald-AI/splitrail)
- [tokscale on GitHub](https://github.com/junhoyeo/tokscale)