Developer Tools & Infrastructure Active v0.1.1 2026 MIT

MiMo-Streak

Terminal activity heatmap, model breakdown, and cost tracker for MiMoCode

TypeScriptNode.jsMiMoCodeWCAG AAATerminal CLI
MiMo-Streak editorial woodblock artwork
Linux & macOS
pnpm dlx mimo-streak
Windows (PowerShell)
pnpm dlx mimo-streak
Domain Developer Tools & Infrastructure
Languages TypeScript, SQLite
License MIT
Status Active
The Problem

Why This Was Built

Developers using MiMoCode lack a lightweight, terminal-native way to track model usage split, daily API expenditures, and coding streaks across projects.

The Solution

The Architectural Answer

A fast, zero-dependency TypeScript CLI that reads local MiMoCode SQLite logs and renders WCAG AAA accessible activity heatmaps, model breakdowns, and project analytics directly in the terminal.

Capabilities

Key Features & Architecture

5-level GitHub-style activity heatmap with today indicator (◈) and streak tracking (current and longest consecutive days)
Token usage and API cost breakdown by model (mimo-streak models)
Project directory activity breakdown and session counting (mimo-streak projects)
Weekly trend sparklines and summary metrics (mimo-streak trends)
Adaptive color rendering for light and dark terminal backgrounds adhering to WCAG AAA contrast
Zero native dependencies using Node.js built-in node:sqlite module
JSON output support (--json) for scripting and dashboard automation
Configurable heatmap width from 4 to 104 weeks and project filtering
Engineering

Technical Specifications

Primary Languages
TypeScriptSQLite
Frameworks & Tooling
Node.js (>=22.5.0)node:sqlite
Architecture & Execution Model
Zero native dependencies, built-in node:sqlite parser, WCAG AAA adaptive palette
Licensing Model
MIT (permissive)
Release & Lineage
Active release cycle since 2026 · Maintained by @JadMadi
Knowledge

Frequently Asked Questions

Does MiMo-Streak support both light and dark terminals?

Yes. It automatically detects terminal background luminance and renders adaptive ANSI colors with WCAG AAA contrast.

What are the runtime requirements to run MiMo-Streak?

MiMo-Streak requires Node.js >= 22.5.0 to use the built-in node:sqlite module without any native compiler dependencies.

Where does MiMo-Streak read data from?

It reads local SQLite data directly from ~/.local/share/mimocode/mimocode.db (or a custom path via --db). No data ever leaves your machine.

How do I run MiMo-Streak on-demand without installing?

Run it instantly using pnpm dlx mimo-streak or npx mimo-streak.