peekm

Real-time observability for AI coding sessions.

A local dashboard that tracks every file edit, tool call, and conversation from Claude Code — across all your projects at once. peekm.dev

AI coding agents edit dozens of files per session. You get a git diff and a JSONL log. Neither tells you what's happening right now, which session changed which file, or what the AI was thinking.

peekm gives you a live timeline of every session, every file edit, and every AI conversation — across all your projects, from one local UI.

All data stays local. No accounts. No telemetry. Open source (Apache 2.0).

Getting Started

npx @peekm/peekm .

Requires Claude Code for AI tracking. Setup is automatic on first run.

Start a Claude Code session in any project. Watch the timeline update in real time.

Run peekm setup autostart to launch peekm automatically on login.

Or install globally: npm i -g @peekm/peekm | brew install razvandimescu/tap/peekm

Works with Claude Code today. More agents coming.

What You Get

AI session observability:

• Timeline — every AI session across all projects, grouped by day. Live status shows which tool the AI is using right now. Duration, file counts, tool breakdown, All/Edits-only filter
• Transcript viewer — read the full AI conversation for any session. Tool calls, code diffs, and reasoning rendered inline
• Memory browser — see what Claude remembers about each of your projects
• Real-time notifications — toast the instant AI modifies a file, with live reload via SSE

Also included:

• Sharing — share any file (Markdown, HTML, SVG, TXT) via LAN or public URL via share.peekm.dev (opt-in, 1-hour TTL, no account). HTML shares include co-located assets (CSS, JS, images)
• File viewer — VS Code-style sidebar with Markdown, HTML, SVG, and TXT support. Fuzzy search (Cmd/Ctrl+P), in-browser editing (Markdown), syntax highlighting, light/dark/auto themes
• Smart folders — "Recent AI Edits" surfaces files touched by AI in the last 24 hours
• Persistent history — events survive restarts via ~/.peekm/events.jsonl

Why This Exists

Git diffs show results. Transcript viewers show history. Neither tells you what's happening right now or connects changes to the AI's reasoning. When you're running multiple agents across projects, you need one place to see all of it — live.

peekm correlates file edits with session metadata and conversations, giving you a unified timeline that updates as the AI works.

How It Works

peekm installs a PostToolUse hook into Claude Code that reports session metadata to a local HTTP server. File changes are correlated with session data and served through a local web UI with SSE for live updates. No data leaves your machine unless you opt into public sharing.

Setup is automatic — peekm detects ~/.claude on first run and configures hooks. Run peekm setup claude-code --remove to undo.

Installation

npm (recommended)

npm i -g @peekm/peekm

Try without installing: npx @peekm/peekm . | Upgrade: npm update -g @peekm/peekm

Homebrew

brew install razvandimescu/tap/peekm

curl

curl -L https://github.com/razvandimescu/peekm/releases/latest/download/peekm_$(uname -s)_$(uname -m).tar.gz | tar xz && sudo mv peekm /usr/local/bin/

Go

go install github.com/razvandimescu/peekm@latest

All releases — macOS, Linux, Windows.

Usage

peekm .                 # browse current directory — AI tracking auto-starts
peekm README.md         # view a single file
peekm -port 8080 .      # custom port

AI tracking is on by default when ~/.claude exists. Disable with -no-ai-tracking.

Flag	Default	Description
-port	6419	Port to serve on
-browser	true	Auto-open browser
-no-ai-tracking	false	Disable AI tracking

Sharing — click the share button in the top bar.

• LAN (default): token-scoped URL on your local network. Recipients see a read-only rendered view with live reload.
• Public (opt-in): click "Make public" to tunnel through share.peekm.dev. HTTPS URL, expires after 1 hour, no account needed.

Background Service

Run peekm automatically on login:

peekm setup autostart          # install (launchd / systemd / Windows)
peekm setup autostart --remove # uninstall

This ensures the timeline captures every AI session without manual launch.

Ignoring Directories

peekm excludes .*, node_modules, vendor, dist, venv, target, __pycache__ by default. Custom exclusions go in .peekmignore:

target
_site
*.tmp

peekm --show-ignored to see all active exclusions.

Requirements

Claude Code (for AI tracking). macOS, Linux, or Windows. No runtime dependencies — peekm is a single static binary.

FAQ

Does peekm send my code anywhere? No. Everything stays on your machine. Public sharing is opt-in and only shares the specific file through a relay — your codebase is never exposed.

Why not just read the JSONL or git log? You can. peekm adds session correlation (which changes belong to which AI conversation), real-time notifications, and a visual timeline that makes it practical to monitor multiple projects simultaneously.

Does it work with Cursor / Copilot / Aider? Not yet. Claude Code exposes PostToolUse hooks that make real-time tracking possible — we're adding more agents as they expose similar capabilities. Open an issue to request yours.

Development

Go 1.24+. make all runs build, test (-race), and lint.

Contributing

PRs welcome. Open an issue if something breaks.

License

Apache 2.0 — see LICENSE.

---

Try it now: npx @peekm/peekm .