gitwtfhub

wtf is minelogue?

wezzard/minelogue — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A dashboard that turns Claude Code and OpenCode agent session logs into browsable, interactive timelines and transcripts.

Mindmap

mindmap
  root((Minelogue))
    What it does
      Timelines from agent logs
      Subagent spawn view
    Tech stack
      Python
      SQLite
      JavaScript
    Use cases
      Browse Claude Code sessions
      Audit log structures
    Audience
      Coding agent developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Browse a Claude Code or OpenCode agent session as an interactive timeline instead of raw logs.

REASON 2

Inspect subagent spawn chains and message details from a coding agent session.

REASON 3

Scan agent log files to understand what message types and structures they contain.

What's in the stack?

PythonSQLiteJavaScript

How it stacks up

wezzard/minelogue920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires uv and existing Claude Code or OpenCode session data to browse.

AGPL 3.0 for the open source code, meaning modifications and hosted use must also be shared under the same license, with a separate commercial license available for proprietary use.

Wtf does this do

Minelogue is a tool for looking through the log files left behind by AI coding agent sessions, specifically Claude Code, which stores logs as JSONL files, and OpenCode, which stores them in SQLite. Instead of scrolling through raw log files, Minelogue turns a session into an interactive timeline and transcript you can browse in a web dashboard, including the many separate subagent conversations that can branch off from a main session and how they were spawned. The name is a play on words, combining mine as in extracting something valuable with the ending of words like dialogue and monologue, plus a nod to log files. The stated roadmap is to first make every session's conversation easy to browse, which is what it does today, then add the ability to cross examine what shows up in a session, and eventually support having an AI agent judge and grade other agent sessions. You run it as a local Python application, pointing it at your Claude Code and OpenCode data folders, and it opens a dashboard in your browser. A lot of engineering effort has gone into making this fast even for very large sessions: instead of loading full message contents up front, it loads lightweight previews first and only pulls in full details for a message when you actually need to see it, and it keeps a local cache so that reopening a session you have already viewed is close to instant. The interface includes clearly labeled elements meant for automated browser testing, and the project ships its own test scripts that build sample sessions and check that the dashboard renders correctly. The project also includes standalone utility scripts for scanning Claude Code log files to understand the different kinds of messages and structures that appear in them, useful if you are building your own tooling around these logs. Minelogue uses a dual license setup. The core source code is released under the AGPL 3.0 license, and a separate commercial license is available for anyone who wants to use it in closed source or proprietary products where the AGPL terms would not fit.

Yoink these prompts

Prompt 1
Explain how Minelogue's boot payload keeps large agent sessions fast to load.
Prompt 2
Help me run Minelogue against my own ~/.claude/projects session logs.
Prompt 3
Show me how to use the scan_claude_message_kinds.py script to audit my session transcripts.

Frequently asked questions

wtf is minelogue?

A dashboard that turns Claude Code and OpenCode agent session logs into browsable, interactive timelines and transcripts.

What language is minelogue written in?

Mainly Python. The stack also includes Python, SQLite, JavaScript.

What license does minelogue use?

AGPL 3.0 for the open source code, meaning modifications and hosted use must also be shared under the same license, with a separate commercial license available for proprietary use.

How hard is minelogue to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is minelogue for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.