⚡ Open Source · 100% Local · Zero Cloud · Zero Cost

Your coding life,
automatically recorded.

TimeStream runs silently in your system tray and automatically logs every meaningful developer activity — no manual input, no timers, no friction. Just open your laptop and your day gets recorded.

100%
Local & Private
$0
Forever Free
10+
Tracked Sources
2
Browser Extensions
TimeStream v1.2.0 — Live Demo
TimeStream App Demo
The Problem

Can you remember what you did last week?

You code for hours. You watch tutorials. You chat with AI. You browse GitHub. But at the end of the week — can you actually remember what you did? Most developers have zero visibility into their own habits. You can't improve what you can't measure.

🏆 "The developer who reflects grows fastest."
☁️

Cloud Data Leaks

Tools like RescueTime upload your private codebase activity, browsing data, and terminal commands to remote servers you don't control.

💸

Expensive Subscriptions

WakaTime, Toggl, Clockify all lock their most useful features behind $10–$20/month plans that don't justify the value.

⏱️

Manual Start/Stop Timers

Nobody actually remembers to clock in and out. Manual tracking is inconsistent, inaccurate, and adds cognitive friction to your flow.

Core Pillars

Built on 4 unbreakable principles

Every design decision in TimeStream is driven by what developers actually need.

⚡

Zero-Friction

Install once and forget it. TimeStream runs silently in your system tray, capturing everything automatically without interrupting your flow.

🔒

100% Private

Every byte of your data stays on your hard drive. No cloud sync, no remote analytics, no third-party servers. TimeStream can never see your data.

🤖

AI Intelligence

Natively parses Claude Code & OpenCode terminal sessions to surface exactly what files you changed, how long you worked, and how many errors were fixed.

🎨

Developer-First

Oceanic Dark/Light modes, live dynamic CSS accent colors, streak gamification, and personalized emoji developer profiles.

What TimeStream Tracks

Everything you build, browse & learn

TimeStream captures your full developer workflow across every tool you use — automatically.

🌐 Browser Activity

🎬 YouTube Educational videos (smart AI filter)
🐙 GitHub Repos, PRs, issues, commits
🤖 ChatGPT Your conversation topics
🧠 Claude AI Your AI prompts & sessions
🔍 Perplexity Research queries
💬 Reddit Tech & programming posts

💻 Local Dev Activity

⚡ OpenCode Coding sessions + duration
🤖 Claude CLI Agent conversations
📊 Learning time Exact minutes spent learning
🔥 Daily streaks Consecutive active days
📈 Weekly patterns Your peak productivity hours
Smart Intelligence

How smart is the YouTube filter?

Most tracking apps log everything. TimeStream uses a multi-signal scoring algorithm to decide if a YouTube video is actually educational before logging it.

+4 pts📌 Strong learning keyword in title ("tutorial", "how to", "explained")
+1.5🏷️ Tech keyword in title ("React", "Docker", "Python"...)
+4 pts🎓 Known educational channel (Fireship, FreeCodeCamp, NeetCode...)
+0.5📝 Educational cues in description ("source code", "follow along"...)
+0.5#️⃣ Tech hashtags found in description

Score ≥ 3 → ✅ Logged as "Learning"
Score < 3 → ❌ Silently ignored

"Top 10 Minecraft Moments" — ignored.
"Building a REST API with Node.js — Full Tutorial" — logged ✅
Core Features

Everything you need.
Nothing you don't.

TimeStream covers your full developer workflow from a beautiful dashboard to deep AI session intelligence.

📊

Analytics Dashboard

See your weekly and monthly activity bar chart. Find out which category consumes most of your time — Coding, Learning, Research, or DevOps. All from real data, zero guesswork. Includes daily goal progress and streak counters.

🕐

Timeline View

A chronological feed of everything you did, hour by hour. Filter by category. Click any card to re-open the source. Think of it as your personal developer logbook — automatically written for you every day.

🧠

AI Session Learnings (Unique Feature)

TimeStream imports your OpenCode and Claude CLI sessions — including project context, conversation summaries, session duration, files modified, and errors fixed — into a dedicated Learnings view. No other time tracker does this.

🔎

Powerful Search

Instantly search across your entire history. "What was that React tutorial I watched last week?" — found in milliseconds. Full-text search across titles, categories, and sources.

🎨

Full Theme Customization

Oceanic Dark & Light modes. Live dynamic CSS accent color injection — choose from Teal, Blue, Violet, Rose, or Amber. Personalized emoji developer profile with name, role, and avatar selector. All persisted instantly via localStorage.

🔒

100% Local & Private

All data lives on your machine. There is no server. No cloud. No tracking. No accounts. TimeStream can never see your data. The local Node.js server is only accessible from your own machine at localhost:3000.

Architecture

How it works under the hood

A clean, local-first data pipeline engineered for reliability and privacy.

┌─────────────────────────────────────────────────────────────┐
│                     YOUR BROWSER                                   │
│  Chrome / Firefox Extension silently watches your tabs       │
│  ▸ Detects GitHub, YouTube, Reddit, AI tools                 │
│  ▸ Applies smart filters (3-min rule + content scoring)     │
└──────────────────────────┬──────────────────────────────────┘
                          │ POST localhost:3000/api/activity
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                 TIMESTREAM DESKTOP APP                       │
│  Electron main process receives and deduplicates events    │
│  ▸ Persists to local JSON (activities.json)                  │
│  ▸ Watches OpenCode + Claude CLI session files               │
│  ▸ Sends live updates to the renderer via IPC                │
└──────────────────────────┬──────────────────────────────────┘
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                      YOUR DASHBOARD                          │
│  Beautiful UI: Timeline · Analytics · Search · Learnings    │
└─────────────────────────────────────────────────────────────┘
1

Browser Extension Logs Your Activity

The custom Chrome (Manifest V3) and Firefox extension silently monitors your tabs. It applies a smart 3-minute rule and content scoring algorithm before logging anything — noise is filtered out automatically.

chrome-extension/ · firefox-extension/
2

Data POSTs to Your Local Node.js Server

The extension securely POSTs activity data to localhost:3000 — a lightweight HTTP server running inside Electron. Only your machine can reach it. Full CORS protection applied.

POST localhost:3000/api/activity
3

Async Write Queue Safely Persists Data

An async write-queue deduplicates and safely writes all data to a local JSON file, preventing corruption under heavy concurrent I/O load. Activities are capped at 1,000 entries with smart deduplication.

~/.config/TimeStream/activities.json
4

File Watcher Monitors AI CLI Sessions

A Node.js fs.watch() observer monitors your OpenCode and Claude CLI session directories in real-time, parsing raw JSON logs into structured session cards automatically.

~/.opencode/sessions/ · ~/.claude/projects/
5

Beautiful Dashboard Renders Everything

All data is visualized across the Dashboard, Timeline, Learnings, Analytics, and Search pages — built with Vanilla JS and dynamic CSS variable theming via Electron IPC.

Electron IPC · renderer/index.html
Tech Stack

Built with modern, battle-tested tools

Carefully chosen for reliability, performance, and zero-friction developer experience.

Layer Technology Why
Desktop Electron 41 Linux-first native cross-platform app
Extension Manifest V3 (Chrome + Firefox) Secure, modern extension API
File Watching chokidar 5 Reliable cross-platform FS events
Local DB better-sqlite3 Fast, zero-config embedded SQL
Frontend Vanilla JS + CSS Zero build step, fast iteration
Packaging electron-builder AppImage + .deb for Linux
CI/CD GitHub Actions Automated builds, testing & releases
CI/CD Pipeline

Automated from push to release

GitHub Actions handles automated testing, extension packaging, and release creation on every version tag push.

⚡ Continuous Integration (every push to main)

Install dependencies
Validate manifests (jq)
Package Chrome extension
Package Firefox extension
Upload build artifacts

🚀 Release Workflow (on version tag push)

Build extension zip
Create GitHub Release
Attach extension files
Auto-generate changelog
What's Coming Next

The roadmap ahead

TimeStream is actively developed. Here is what's on the horizon.

🗓️GitHub-style heatmap — see your consistency at a glance
📁Project tagging — group activities into named projects
📤Weekly Markdown reports — export your week to share or reflect
💻VS Code extension — track files and features you touch
🍅Pomodoro integration — link focus sessions to activities
🌍Multi-language support
Setup Guide

Get started in 5 minutes

TimeStream runs on Linux (Ubuntu 20.04+ recommended) and requires Node.js v18+ and npm v8+.

Step 1 — Prerequisites

Make sure you have Node.js v18+, npm v8+, and build tools installed.

sudo apt install build-essential

Step 2 — Clone & Install

git clone https://github.com/[your-repo]/TimeStream.git
cd TimeStream
npm install && npx @electron/rebuild

Step 3 — Run the App

npm run dev

Step 4 — Install the Browser Extension

Chrome: Go to chrome://extensions → Enable Developer Mode → Load Unpacked → select chrome-extension/


Firefox: Go to about:debugging → This Firefox → Load Temporary Add-on → select firefox-extension/manifest.json

Step 5 — Browse Normally

TimeStream is now active. Open GitHub, watch a tutorial, chat with AI — your timeline will populate automatically within minutes.