Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@suncreation/modu-arena) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@suncreation/modu-arena

Track and rank your AI coding tool usage across Claude Code, OpenCode, Gemini CLI, Codex CLI, and Crush.

Quick Start

npx @suncreation/modu-arena install --api-key <your-api-key>

Get your API key from the Modu-Arena dashboard.

Commands

`install`

Set up tracking hooks for all detected AI coding tools.

npx @suncreation/modu-arena install --api-key modu_arena_xxxxxxxx_yyyyyyyy

This will:

Save your API key to ~/.modu-arena.json
Detect installed AI coding tools
Install session-end hooks for each detected tool

`rank`

View your usage stats.

npx @suncreation/modu-arena rank

Shows total tokens, sessions, tool breakdown, and 7/30-day trends.

`status`

Check your current configuration and installed hooks.

npx @suncreation/modu-arena status

`uninstall`

Remove all hooks and configuration.

npx @suncreation/modu-arena uninstall

Supported Tools

Tool	Detection	Hook Location
Claude Code	`~/.claude/`	`~/.claude/hooks/session-end.sh`
OpenCode	`~/.opencode/`	`~/.opencode/hooks/session-end.sh`
Gemini CLI	`~/.gemini/`	`~/.gemini/hooks/session-end.sh`
Codex CLI	`~/.codex/`	`~/.codex/hooks/session-end.sh`
Crush	`~/.crush/`	`~/.crush/hooks/session-end.sh`

Configuration

Config is stored in ~/.modu-arena.json:

{
  "apiKey": "modu_arena_xxxxxxxx_yyyyyyyy",
  "serverUrl": "https://your-server.com"
}

Custom Server URL

MODU_ARENA_API_URL=https://your-server.com npx @suncreation/modu-arena install --api-key <key>

How It Works

Install sets up lightweight shell hooks in each tool's config directory
When a coding session ends, the hook sends token usage data to the Modu-Arena server
Data includes: input/output tokens, cache tokens, model name, and timing
All submissions are authenticated with HMAC-SHA256 signatures
View your stats via rank command or the web dashboard

Security

API keys are stored locally in ~/.modu-arena.json
All API requests use HMAC-SHA256 signature verification
Session data is hashed server-side for integrity and deduplication
No source code or project content is ever transmitted

Requirements

Node.js 20+
One or more supported AI coding tools installed

License

MIT