oh-my-hi 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,25 @@
+{
+  "name": "oh-my-hi",
+  "metadata": {
+    "description": "Claude Code harness insights dashboard"
+  },
+  "owner": {
+    "name": "Jae Sung Park",
+    "email": "alberto.park@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "oh-my-hi",
+      "description": "Visual dashboard for Claude Code harness — usage/token analysis of skills, agents, plugins, hooks, memory, MCP servers, rules, and principles",
+      "version": "0.1.0",
+      "author": {
+        "name": "Jae Sung Park",
+        "email": "alberto.park@gmail.com"
+      },
+      "category": "analytics",
+      "source": "./",
+      "homepage": "https://github.com/netil/oh-my-hi",
+      "keywords": ["dashboard", "harness", "insights", "usage", "tokens", "analytics"]
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jae Sung Park
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+# 👋 oh-my-hi (Oh My Harness Insights)
+![oh-my-hi dashboard](https://img.shields.io/badge/Claude_Code-Plugin-blue)
+
+**Harness Insights** — A visual dashboard for your Claude Code harness.
+
+Parses your entire Claude Code configuration and usage data, then generates an interactive single-file HTML dashboard you can open locally.
+
+
+## What it shows
+
+- **Harness overview** — skills, agents, plugins, hooks, memory, MCP servers, rules, principles, commands, teams, plans
+- **Token analytics** — usage by model, daily trends, cache efficiency, prompt statistics, response latency
+- **Activity heatmaps** — daily usage patterns across skills, agents, and commands
+- **Task categories** — auto-classified token usage by work type (code editing, docs, planning, etc.)
+- **Multi-workspace** — switch between global and per-project scopes
+
+## Installation
+
+```bash
+# 1. Add marketplace
+claude plugin marketplace add github:netil/oh-my-hi
+
+# 2. Install plugin
+claude plugin install oh-my-hi
+```
+
+## Usage
+
+Run in Claude Code:
+
+```
+/omh
+```
+
+This will parse your harness data, build the dashboard, and open it in your browser.
+
+### Parameters
+
+| Command | Description |
+|---------|-------------|
+| `/omh` | Full build — parse data, build web-ui, open in browser |
+| `/omh --data-only` | Regenerate data + web-ui without opening browser |
+| `/omh --enable-auto` | Auto-rebuild on session end (registers Stop hook) |
+| `/omh --disable-auto` | Disable auto-rebuild |
+| `/omh --status` | Check auto-rebuild status |
+| `/omh <path>` | Build with specific project paths only |
+
+### Auto-refresh
+
+Enable automatic data refresh so the dashboard stays up to date:
+
+```
+/omh --enable-auto
+```
+
+This registers a Stop hook that rebuilds the dashboard data whenever a Claude Code session ends. Refresh the browser tab to see the latest data.
+
+## How it works
+
+1. **Parse** — Reads your Claude Code config directory for skills, agents, plugins, hooks, memory, MCP servers, rules, principles, commands, teams, plans, and usage transcripts
+2. **Analyze** — Extracts token usage, prompt stats, response latency, activity patterns from `.jsonl` transcripts
+3. **Classify** — Auto-categorizes token usage into work types (code editing, docs, planning, etc.) based on skill/agent descriptions. Saves to `task-categories.json` for user customization
+4. **Build** — Generates a single `index.html` with all data, CSS, JS, and locale inlined (works with `file://` protocol, no server needed)
+5. **Open** — On macOS, reuses an existing browser tab if found (AppleScript). On Windows/Linux, opens a new tab
+
+## i18n
+
+- **English**: Built-in default
+- **Other languages**: A template locale file is auto-generated on first build. Translate it and rebuild
+
+## Browser support
+
+The dashboard opens as a local `file://` HTML file. No web server required.
+
+On macOS, subsequent builds will refresh the existing browser tab instead of opening a new one (Chrome and Safari supported).
+
+## License
+
+[MIT](LICENSE)

package/SPEC.md

@@ -0,0 +1,160 @@
+# oh-my-hi — Specification
+
+## Overview
+
+Claude Code harness dashboard generator. Invoked as `/omh` skill.
+Parses harness configuration and usage data, builds a single-file HTML dashboard.
+
+## Directory Structure
+
+```
+oh-my-hi/
+├── SKILL.md                     # Skill definition (invoked as /omh)
+├── SPEC.md                      # This file
+├── task-categories.json         # Persistent task category mapping (user-editable)
+├── scripts/
+│   ├── generate-dashboard.mjs   # Main entry point
+│   └── parsers/
+│       ├── agents.mjs           # agents/*.md (frontmatter)
+│       ├── commands.mjs         # commands/*.md (frontmatter)
+│       ├── config-files.mjs     # CLAUDE.md, AGENTS.md, settings.json
+│       ├── frontmatter.mjs      # Shared YAML frontmatter parser
+│       ├── hooks.mjs            # settings.json hooks section
+│       ├── mcp-servers.mjs      # .claude.json, mcp.json (env values masked)
+│       ├── memory.mjs           # projects/*/memory/*.md (excludes MEMORY.md)
+│       ├── plans.mjs            # plans/*.md (plain markdown)
+│       ├── plugins.mjs          # installed_plugins.json + settings.json
+│       ├── rules.mjs            # rules/*.md, principles/*.md (no frontmatter)
+│       ├── scopes.mjs           # Global + project scope detection
+│       ├── skills.mjs           # skills/*/SKILL.md + plugin cache
+│       ├── teams.mjs            # teams/*/config.json
+│       ├── todos.mjs            # todos/*.json
+│       └── usage.mjs            # history.jsonl + transcripts
+├── templates/
+│   ├── dashboard.html           # HTML shell with placeholders
+│   ├── styles.css               # All CSS
+│   ├── app.js                   # Frontend JS (English i18n only)
+│   └── locales/
+│       └── ko.json              # Korean locale (shipped)
+└── output/                      # Generated artifacts
+    ├── data.json                # Raw data (for programmatic access)
+    └── index.html               # Single file with inlined data+locale+CSS+JS
+```
+
+## CLI Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `/omh` | Full build: parse data → build web-ui → open/refresh browser |
+| `--data-only` | Regenerate data + web-ui (skip auto-refresh notice, still opens browser) |
+| `--enable-auto` | Register Stop hook for auto-rebuild on session end |
+| `--disable-auto` | Remove Stop hook |
+| `--status` | Show auto-refresh hook status |
+| `<path> [path...]` | Include only specified project paths |
+| `--help` | Show help |
+
+## Build Pipeline
+
+```
+1. Detect scopes (global + projects)
+2. Parse all data sources per scope
+3. Build task categories (description-based classification → task-categories.json)
+4. Detect system locale → load locales/{locale}.json
+5. Generate data.json
+6. Generate index.html:
+   - dashboard.html template
+   - __STYLES__ → styles.css
+   - __DATA__ → data.json (escaped, inlined)
+   - __LOCALE_DATA__ → locale JSON (with _lang field)
+   - __APP_JS__ → app.js
+7. Open/refresh browser
+```
+
+## Data Sources (13 parsers)
+
+| Parser | Source | Key Fields |
+|--------|--------|------------|
+| config-files | CLAUDE.md, AGENTS.md, settings.json | name, body, jsonContent, jsonStats |
+| skills | skills/*/SKILL.md + plugins/cache | name, description, version, argument-hint, allowed-tools, plugin |
+| agents | agents/*.md | name, description, model |
+| plugins | installed_plugins.json + settings.json | name, marketplace, version, enabled, author |
+| hooks | settings.json hooks | event, matcher, commands |
+| memory | projects/*/memory/*.md | name, description, type, scope |
+| mcpServers | .claude.json, mcp.json | name, command, args, envKeys (values masked) |
+| rules | rules/*.md | name, body (no frontmatter) |
+| principles | principles/*.md | name, body (no frontmatter) |
+| commands | commands/*.md | name, description, allowed-tools |
+| teams | teams/*/config.json | name, description, memberList (name, agentType, model, prompt, color, cwd) |
+| plans | plans/*.md | name, body |
+| todos | todos/*.json | name, total, pending, completed |
+
+### Usage Parser (usage.mjs)
+
+Parses `history.jsonl` and `projects/*/*.jsonl` transcripts.
+
+| Output | Source | Notes |
+|--------|--------|-------|
+| commands | history.jsonl | Filters built-in commands (20 types), file paths |
+| skills | transcript tool_use (name=Skill) | Extracted from input.skill |
+| agents | transcript tool_use (name=Agent) | From input.subagent_type or input.description |
+| mcpCalls | transcript tool_use (name=mcp__*) | Server name from between `__` delimiters |
+| tokenEntries | transcript assistant.usage | input/output/cache tokens, model, context attribution |
+| promptStats | transcript human messages | charLen (text character count) |
+| latencyEntries | human→assistant timestamp diff | 0–600,000ms range, per session |
+
+**Token context attribution**: Tracks most recently active context per session (`skill` / `agent` / `mcp` / `tool` / `general`) and attaches it to each token entry.
+
+## Task Categories
+
+Built at build time in `generate-dashboard.mjs`. Persisted in `task-categories.json`.
+
+**Classification priority**:
+1. `task-categories.json` existing entry → preserved (user edits survive)
+2. Built-in tool name → structural mapping (Edit→code-edit, Bash→execution, etc.)
+3. Skill/agent description + name → keyword matching against category seeds
+4. Fallback → `other`
+
+**Categories**: code-edit, code-search, execution, review, planning, docs, browser, workflow, team, config, general, other
+
+## i18n
+
+- **Base language**: English (hardcoded in app.js `I18N.en`)
+- **Korean**: `locales/ko.json` (shipped with project)
+- **Other locales**: Auto-generated English template on first build if locale file missing
+- **Build injection**: System locale detected → `locales/{locale}.json` loaded → injected as `__LOCALE_DATA__` with `_lang` field
+- **Runtime**: `t()` function checks `I18N[currentLang]` → falls back to `I18N.en`
+- **Template variables**: `{{configDir}}` → `DATA.configDir` (replaced at runtime by `t()`)
+
+## Browser Open/Refresh
+
+| OS | Tab Reuse | Open |
+|----|-----------|------|
+| macOS | AppleScript: Chrome → Safari (search by URL containing "oh-my-hi", reload + activate) | `open` fallback |
+| Windows | — | `start ""` |
+| Linux | — | `xdg-open` |
+
+## Dashboard Pages
+
+| Page | Hash | Content |
+|------|------|---------|
+| Harness Overview | `#overview` | Stats cards, category distribution donut, daily trend, popular skills, activity heatmap, recent activity, insights, unused items |
+| Token Overview | `#tokens` | Token stats, model distribution donut, trend chart, activity heatmap, model table, insights |
+| Token Analysis | `#tokens-analysis` | Task category bar, tool context bar, prompt stats, response latency, session analysis, hourly distribution, cache efficiency |
+| Structure | `#structure` | Component flow SVG, file tree |
+| Help | `#help` | Parameters table, data parsing reference, token/activity reference |
+| Category Overview | `#{categoryKey}` | Total count, usage stats, all items list |
+| Detail View | `#{categoryKey}/{name}` | Per-item detail (varies by category) |
+
+## Sidebar Categories (13)
+
+Dynamically shown — hidden when item count is 0.
+
+configFiles, skills, agents, plugins, hooks, memory, mcpServers, rules, principles, commands, teams, plans, todos
+
+## Key Architectural Decisions
+
+1. **Data inline (no fetch)**: index.html embeds data.json as `DATA` variable. Required for file:// protocol compatibility.
+2. **Single output file**: All CSS, JS, data, locale inlined into index.html. No external dependencies except CDN (billboard.js, d3).
+3. **Persistent category mapping**: `task-categories.json` survives rebuilds. User can manually reclassify items.
+4. **Locale built once**: Locale file generated on first build for unknown locales. Not rebuilt on subsequent runs.
+5. **AppleScript tab reuse**: macOS-only optimization. Searches all browser windows/tabs for URL match.

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "oh-my-hi",
+  "version": "0.1.0",
+  "description": "Claude Code harness insights dashboard",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/netil/oh-my-hi.git"
+  },
+  "author": "Jae Sung Park <alberto.park@gmail.com>",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "dashboard",
+    "harness",
+    "insights",
+    "analytics"
+  ],
+  "homepage": "https://github.com/netil/oh-my-hi"
+}