whatisgithub

What is claude2stream?

broady/claude2stream — explained in plain English

Analysis updated 2026-05-18

★ 111TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A tool that turns your local Claude Code conversation history into a live-updating web page you can watch in real time.

Mindmap

mindmap
  root((claude2stream))
    What it does
      Watches Claude session files
      Streams them live
      Web UI viewer
    Tech stack
      Go backend
      Web frontend
      Docker
    Use cases
      Monitor active sessions
      Review past conversations
      Self host on your machine
    Audience
      Developers using Claude Code
      Tinkerers
      Self hosters

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

What do people build with it?

USE CASE 1

Watch your own Claude Code sessions update live in a browser as you work.

USE CASE 2

Review past Claude Code conversations without digging through raw JSONL files.

USE CASE 3

Run it in Docker as a read-only, self-hosted viewer for your local machine.

What is it built with?

GoTypeScriptDocker

How does it compare?

broady/claude2streamplacenl2026/okx-agent-trade-kitjoeseesun/qiaomu-artist-style
Stars111111112
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedeveloperdeveloperdesigner

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Docker is the fastest path, the Docker run mounts your Claude directory as read-only.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

claude2stream is a small tool that reads your local Claude Code conversation history and exposes it as a live-updating web interface. Claude Code stores conversation logs as JSONL files (a line-by-line JSON format) in a directory on your machine. This tool watches that directory and serves a streaming web UI at a local address so you can browse and watch your sessions in real time. The tool is built as a Go backend that monitors the file directory for changes and exposes the conversations as "Durable Streams" (a streaming data format), paired with a web frontend for viewing them in a browser. It can be run via a pre-built binary, built from source, or run as a Docker container. The Docker command mounts your local Claude directory as read-only, so the tool only reads your history and cannot modify it.

Copy-paste prompts

Prompt 1
Help me set up claude2stream with Docker to view my Claude Code sessions.
Prompt 2
Show me how to build claude2stream from source.
Prompt 3
Explain how claude2stream's Go backend watches my Claude directory for changes.
Prompt 4
Walk me through running claude2stream as a read-only Docker container.

Frequently asked questions

What is claude2stream?

A tool that turns your local Claude Code conversation history into a live-updating web page you can watch in real time.

What language is claude2stream written in?

Mainly TypeScript. The stack also includes Go, TypeScript, Docker.

What license does claude2stream use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude2stream to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude2stream for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?