oh-my-agentic-score 0.8.7

Measure agentic coding performance using Thread-Based Engineering framework

Oh My Agentic Score

Measure and visualize your agentic coding performance

Based on IndyDevDan's Thread-Based Engineering framework

---

"If you can't measure it, you can't improve it."

In the age of AI-assisted development, agentic coding — the ability to collaborate effectively with AI agents — is becoming an essential skill for every developer. But how do you know if you're actually getting better at it? You can't improve what you can't measure.

Oh My Agentic Score (OMAS) was born from this belief. Inspired by IndyDevDan's brilliant Thread-Based Engineering framework, this project provides a concrete, data-driven way to measure and visualize your agentic coding performance.

OMAS analyzes your Claude Code session logs and scores your performance across four dimensions: parallelism, autonomy, density, and trust. Track your growth from basic conversations to fully autonomous Z-threads — and push yourself to become a better agentic developer.

Installation

One-line install (recommended)

curl -fsSL https://raw.githubusercontent.com/HwangTaehyun/oh-my-agentic-score/main/install.sh | bash

Homebrew (macOS)

brew install HwangTaehyun/tap/oh-my-agentic-score

pip / uv

pip install oh-my-agentic-score

# or with uv (faster)
uv tool install oh-my-agentic-score

Quick Start

# Scan all Claude Code sessions
omas scan

# View your report
omas report

# Launch interactive dashboard
omas dashboard

Cloud Ranking (Optional)

Upload your scores and compare with other developers at oh-my-agentic-score.com:

# 1. Authenticate via GitHub
omas auth login

# 2. Scan & upload in one step
omas dashboard              # auto-scans, exports, uploads, and launches dashboard

# Or upload manually
omas upload                 # upload to cloud
omas upload --dry-run       # preview what will be uploaded

# 3. Check your ranking
#    Visit https://oh-my-agentic-score.com

All uploads are privacy-safe — project paths are hashed (SHA-256), no source code is ever transmitted.

Features

Four-Dimension Scoring (0-10 scale)

Dimension	Thread	What It Measures
More	P-thread	Concurrent sessions running simultaneously (cross-session parallelism)
Longer	L-thread	Autonomous work duration without human intervention (idle gaps capped at 30min)
Thicker	B-thread	Work density (sub-agent depth, orchestration breadth, tool calls per minute, AI-written lines bonus)
Fewer	Z-thread	Human checkpoint reduction (ratio-only, trivial delegations excluded, Plan Mode AskUser exempt)

Seven Thread Types

Sessions are classified into one of seven thread types (highest priority first):

Z-thread  Zero-touch    Minimal human input, maximum autonomous work
B-thread  Big           Nested sub-agents (agents spawning agents)
L-thread  Long          30+ minutes autonomous stretch, 50+ tool calls
F-thread  Fusion        Similar tasks distributed to multiple agents
P-thread  Parallel      2+ concurrent agent execution paths
C-thread  Chained       Multiple human checkpoints with work between each
Base      Default       Standard conversation

CLI Commands

omas scan                    # Scan all sessions, build metrics DB
omas analyze <session-id>    # Analyze a single session
omas report                  # Full report with comparison metrics
omas trend                   # Score trends over time
omas export                  # Export JSON for dashboard
omas dashboard               # Launch Next.js dashboard
omas list                    # List discovered sessions
omas tui                     # Interactive TUI (via Trogon)
omas auth login              # OAuth login (GitHub)
omas auth status             # Check auth status
omas upload --dry-run        # Preview cloud upload

Next.js Dashboard

Interactive web dashboard with:

• Radar chart across all 4 dimensions
• Thread type distribution pie chart
• Score trends over time
• Per-project breakdown
• Session detail views

Fair Comparison System

To prevent short test sessions from skewing scores:

• Minimum Thresholds: Sessions must have 5+ min duration, 10+ tool calls, 1+ human messages
• Weighted Scoring: Longer, more complex sessions get proportionally more weight
• Consistency Score: Measures score stability across recent sessions
• Composite Rank: weighted_score * 0.8 + consistency * 0.2

Textual TUI

Interactive terminal UI powered by Textual and Trogon:

omas tui    # Opens form-based CLI interface

Architecture

Claude Code JSONL logs (~/.claude/projects/)
        │
        ▼
   omas scan          Parse & analyze all sessions
        │
        ├─► SQLite DB (~/.omas/metrics.db)     Local storage (always)
        │
        ├─► metrics.json                        Dashboard data
        │
        └─► Cloud upload (optional)             Background sync
             └─► upload_queue.json              Retry queue on failure

Offline-First Design

• Analysis results always save to local SQLite first
• Cloud upload is automatic but optional
• Network failures queue data for retry (max 5 attempts)
• Dashboard works entirely from local data

Privacy

• Project paths are hashed before cloud upload (no directory names exposed)
• Session IDs retained for deduplication only
• No source code or file contents are ever transmitted

How It Works

OMAS parses Claude Code's JSONL session logs from ~/.claude/projects/. For each session:

1. Parser extracts tool calls, user messages, sub-agent events, and token usage
2. Metrics compute four independent dimension scores using log-normalized scaling
3. Classifier determines the thread type using priority-based rules
4. Storage persists to SQLite for historical tracking
5. Display renders via Rich terminal UI or Next.js dashboard

Key Algorithms

• Cross-session sweep-line for peak concurrent session detection (parallelism) — avoids over-counting from pairwise overlap
• Linear agent counting for density scoring (total agents capped at 10, plus AI-written lines bonus)
• Activity-based autonomy measurement (measures to Claude's last activity, not next human message)
• Idle gap capping at 30 minutes to prevent inflated autonomy scores from idle periods
• Jaccard similarity for fusion thread detection
• P90 percentile scoring for autonomy — 90th percentile of autonomous stretches, excluding outliers
• Log normalization (log1p(x) * k) for unbounded metrics (0-10 scale; k=2.5 for autonomy, k=2.0 for trust)
• Trivial delegation filter excludes simple human commands (≤5 tool calls) from trust ratio
• Plan Mode awareness exempts AskUserQuestion during planning from penalty
• Human message filtering with 24 automated patterns + minimum length (3 chars)

Improving Your Score

Base → C-thread    Use 3+ conversation turns with work between each
C    → P-thread    Request parallel tasks ("analyze these 3 files simultaneously")
P    → L-thread    Give detailed instructions, let Claude work 30+ minutes
L    → B-thread    Use teams/worktrees for deep sub-agent hierarchies
B    → Z-thread    One command, full feature implementation, auto-approve

Key tips:

• Write a detailed CLAUDE.md with project conventions
• Give complete requirements upfront instead of incremental instructions
• Enable auto-approve for permissions to avoid interruptions
• Use Agent tool for independent parallel work

Development

git clone https://github.com/HwangTaehyun/oh-my-agentic-score.git
cd oh-my-agentic-score
uv sync
uv run omas --help

Dashboard (Dev Mode)

When running from a git clone, the bundled dashboard is not included. Build the static export first, then omas dashboard serves it via a pure Python HTTP server (no Node.js runtime needed after build):

# 1. Build the dashboard static export (one-time, or after source changes)
cd dashboard
npm install   # or: bun install
npm run build # generates dashboard/out/
cd ..

# 2. Scan sessions and launch dashboard
uv run omas scan
uv run omas dashboard

Note: omas dashboard automatically runs scan + export before launching. If dashboard/out/ exists, it serves via Python's built-in HTTP server. If dashboard/out/ is missing and node_modules/ exists, it falls back to npx next dev.

See CONTRIBUTING.md for full development setup.

Documentation

Full documentation is available at hwangtaehyun.github.io/oh-my-agentic-score.

Credits

• Framework: IndyDevDan's Thread-Based Engineering
• Inspired by: oh-my-opencode
• TUI: Textual + Trogon by Will McGugan

Tip

Be with us!

  Found a bug or have a feature idea? Open an issue — all feedback is welcome.

  Reach out directly for questions, suggestions, or collaboration.

  Follow @HwangTaehyun on GitHub for more projects.

License

MIT - Taehyun Hwang