https://github.com/juliantanx/aiusage

Open-source AI usage tracker — tokens, cost, and sessions across Claude Code, Codex, Hermes, Qoder, and more
https://github.com/juliantanx/aiusage

ai ai-analytics ai-coding-assistant ai-usage aiusage better-sqlite3 claude claude-code cli codex cost-tracking dashboard developer-tools react token-tracker token-usage typescript

Last synced: 18 days ago
JSON representation

Open-source AI usage tracker — tokens, cost, and sessions across Claude Code, Codex, Hermes, Qoder, and more

• Host: GitHub
• URL: https://github.com/juliantanx/aiusage
• Owner: juliantanx
• License: mit
• Created: 2026-05-12T09:29:47.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-06-01T05:38:46.000Z (20 days ago)
• Last Synced: 2026-06-01T07:07:27.659Z (20 days ago)
• Topics: ai, ai-analytics, ai-coding-assistant, ai-usage, aiusage, better-sqlite3, claude, claude-code, cli, codex, cost-tracking, dashboard, developer-tools, react, token-tracker, token-usage, typescript
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/@juliantanx/aiusage
• Size: 15.6 MB
• Stars: 52
• Watchers: 0
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# aiusage — AI Coding Assistant Usage Tracker

[![npm version](https://img.shields.io/npm/v/@juliantanx/aiusage)](https://www.npmjs.com/package/@juliantanx/aiusage)

[![CI](https://github.com/juliantanx/aiusage/actions/workflows/test.yml/badge.svg)](https://github.com/juliantanx/aiusage/actions/workflows/test.yml)

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

**[aiusage.jtanx.com](https://aiusage.jtanx.com)** · English | [中文](https://github.com/juliantanx/aiusage/blob/main/README_zh.md)

Track token usage, cost, and sessions across **22 AI coding tools** in one local dashboard. No accounts. No telemetry. No cloud required.



  

  

  



## Quick Start

**Prerequisites:** Node.js 20+

```bash

npm install -g @juliantanx/aiusage

aiusage parse

aiusage serve

```

Open `http://localhost:3847` to explore the dashboard.

## Supported Tools

| | | | | |

|---|---|---|---|---|

| `Claude Code` | `Codex` | `OpenCode` | `Cursor` | `Hermes` |

| `Qoder` | `OpenClaw` | `KiloCode` | `Copilot` | `Gemini CLI` |

| `Kimi Code` | `CodeBuddy` | `Kiro` | `Grok Build` | `Antigravity` |

| `Roo Code` | `Zed` | `Goose` | `oh-my-pi` | `pi` |

| `Craft` | `Droid` | | | |

## Why aiusage

Your AI coding tools each log usage separately — different formats, different machines, no shared view. aiusage pulls it all into one local dashboard:

- **One dashboard** for tokens, cost, model mix, and tool-call activity

- **Multi-machine sync** via GitHub, S3, or R2 — entirely optional

- **Your data stays local** by default

## Documentation

Full documentation — CLI reference, Docker deployment, sync setup, desktop widget, and more — is available on the **[Docs page](https://aiusage.jtanx.com/docs)**.

## Friends

[**linux.do**](https://linux.do/) — Thanks to the linux.do community for their support and inspiration during the development of this project.

## Star History



 

   

   

   

 



## Contributing

Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for how to get started.

## License

[MIT](./LICENSE)