@myhpmp/cli

한국어 | English

RPG-style gamified usage dashboard for AI coding tools.

Turn your AI coding tool usage into a game — track your level, HP (session limit), MP (weekly limit), EXP, streaks, and earn titles as you code.

Supported Tools

Feature	Claude Code	Codex CLI
Status line (real-time HUD)	O	X
HP / MP (rate limit tracking)	O	X
Context window tracking	O	X
Real-time token tracking	O	X
Session-end token tracking	O	O
EXP / Level / Streak	O	O
Cross-device sync	O	O

Claude Code provides the full experience. Codex CLI supports EXP tracking and leveling, but real-time status display is not available due to Codex CLI hook limitations.

Status Line (Claude Code)

Always visible at the bottom of Claude Code:

⚔️ Token Explorer Lv.9 ★★★ | ❤️ 43% ⏱️2h30m | 💙 76% | 🧠 25% | 🔥7d | 📂 ~/…/code/my-project

Detail View

Run myhpmp usage for the full dashboard:

🎮 ⚔️ Token Explorer Lv.9 ★★★            🔥 Streak: 7d
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❤️ HP  ████░░░░░░   43%  ⏱️ 2h30m
💙 MP  ████████░░   76%
🧠 CTX ███░░░░░░░   25%  (250K / 1.0M context)
⭐ EXP ██████░░░░   62%  (186 / 300 → Lv.10)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 Total EXP: 2,886  |  Total Sessions: 47 sessions

Stats

Stat	Description
❤️ HP	5-hour session limit remaining (%) + reset timer
💙 MP	7-day weekly limit remaining (%)
🧠 CTX	Current context window usage (%)
🔥 Streak	Consecutive days of usage
⭐ EXP	Experience points toward next level

Level Tiers

Level	Title	EXP/Level	Cumulative
1-5	🌱 Prompt Newbie	100	500
6-10	⚔️ Token Explorer	300	2,000
11-15	🛠️ Prompt Engineer	600	5,000
16-20	🏗️ Context Architect	1,200	11,000
21-30	🔮 Prompt Sorcerer	3,500	46,000
31-40	👑 Model Master	8,000	126,000
41-50	🐉 Context Overlord	15,000	276,000
50+	⚡ Synthetic Mind	25,000	∞

Early levels fly by. Late tiers require serious dedication — expect ~8 months of daily use to reach ⚡ Transcendent.

EXP Sources

Action	EXP
Token usage	1 EXP per 1K tokens
Session complete	25 EXP
Streak bonus	streak days × 5 EXP (cap: 30 days = 150 max)
Weekly 70%+ usage	100 EXP

EXP from all supported tools is combined into a single total. Use Claude and Codex together — it all adds up.

Quick Start

# Install globally
npm install -g @myhpmp/cli

# Auto-configure (select Claude Code, Codex, or both)
myhpmp setup

# Set your display language
myhpmp locale

# Restart your AI coding tool to start tracking

That's it! EXP tracking starts via hooks. Status line is available for Claude Code.

Commands

Command	Description
myhpmp setup	Auto-configure hooks (Claude Code / Codex CLI)
myhpmp usage	Show detailed RPG dashboard
myhpmp sync	Manually sync stats to cloud
myhpmp statusline	Toggle status line on/off (Claude Code)
myhpmp statusline on	Enable status line
myhpmp statusline off	Disable status line
myhpmp locale	Change display language (한국어/English)
myhpmp init	Set up authentication (cross-device sync)
myhpmp uninstall	Remove all hooks, status line, and optionally local data

Cross-Device Sync

Sync your stats (level, EXP, streaks) across multiple machines:

myhpmp init

Supports GitHub OAuth and Google OAuth authentication.

How sync works

Timing	Behavior
Session start	Pull latest from cloud → update local
Every 5 minutes	Auto-sync during active use
Session end	Push final stats to cloud
myhpmp sync	Manual sync on demand

Data is stored locally at ~/.myhpmp/data.json and works offline. Cloud sync is best-effort — if it fails, local data is preserved and synced on next opportunity. If local EXP is lower than remote (e.g. after reinstall), remote data is always preserved.

Requirements

• Node.js >= 18
• One or more supported AI coding tools:
  • Claude Code (Pro/Max subscription)
  • Codex CLI (OpenAI API key)

Supported Platforms

• Windows
• macOS
• Linux

i18n

Supports Korean and English. Set your language with myhpmp locale, or it auto-detects from your system locale.

KO: ⚔️ 토큰 익스플로러 Lv.9 ★★★ | ❤️ 43% ⏱️2h30m | 💙 76% | 🧠 25% | 🔥7일 | 📂 ~/…/code/my-project
EN: ⚔️ Token Explorer Lv.9 ★★★ | ❤️ 43% ⏱️2h30m | 💙 76% | 🧠 25% | 🔥7d | 📂 ~/…/code/my-project

How It Works

1. Hooks — Each supported tool's hook system tracks token usage, sessions, and streaks
2. Adapter Pattern — Claude Code and Codex CLI each have their own adapter for parsing tool-specific data
3. Status Line — Claude Code pipes session JSON to the status line script, rendered as RPG HUD
4. Local Store — All data saved to ~/.myhpmp/data.json (works offline)
5. Cloud Sync — Supabase integration with auto-sync. Server-side EXP validation prevents manipulation

License

MIT