---
title: >-
  Open-Streak — GitHub-style terminal activity heatmap and streak tracker for
  OpenCode — by Jad Madi (@jadmadi)
description: >-
  CLI tool that parses your local OpenCode session history to render a
  GitHub-style terminal contribution heatmap, streak statistics, and daily
  activity breakdown.
href: /project/open-streak/
author: Jad Madi
category: Developer Tools & FinOps
domain: Developer Tools & Infrastructure
status: Active Tool
license: MIT
year: '2026'
---
# Open-Streak — GitHub-style terminal activity heatmap and streak tracker for OpenCode

CLI tool that parses your local OpenCode session history to render a GitHub-style terminal contribution heatmap, streak statistics, and daily activity breakdown.

## Project Overview

- **Website**: https://jadmadi.net/project/open-streak/
- **Repository**: https://github.com/jadmadi/open-streak
- **Documentation**: https://github.com/jadmadi/open-streak/blob/main/README.md
- **Package**: https://www.npmjs.com/package/open-streak
- **Domain**: Developer Tools & Infrastructure
- **Category**: Developer Tools & FinOps
- **Status**: Active Tool
- **Year**: 2026
- **License**: MIT (permissive)
- **Author**: [@JadMadi](https://x.com/jadmadi)

## Quick Install & Run

```bash
pnpm dlx open-streak
```

## The Problem It Solves

OpenCode users lack a native, visual overview of their daily coding consistency and agent usage activity.

## The Solution

A terminal CLI tool that extracts session timestamps and renders familiar contribution squares directly in the shell.

## Key Features & Capabilities

- Terminal contribution grid with custom ANSI green shades
- Current streak, longest streak, and total active days calculation
- Zero configuration: auto-detects OpenCode configuration and storage paths

## Technical Specifications & Architecture

- **Languages**: TypeScript
- **Frameworks / Libraries**: Node.js CLI, Chalk
- **Architecture**: Local JSON parser, ANSI terminal renderer
- **License Model**: MIT

## Frequently Asked Questions

### How do I run Open-Streak without permanent installation?

You can run it on-demand with `pnpm dlx open-streak`.

## Links & References

- Project Page on Crosscurrent Code: https://jadmadi.net/project/open-streak/
- Full Projects Directory: https://jadmadi.net/projects/
- Author Profile: https://jadmadi.net/about/