peekm

README

peekm

See what AI coding agents do across all your projects.

AI coding agents run dozens of operations per session — but you only see the final diff. peekm watches all your projects in real time and shows you every session, every file change, and every conversation. It runs as a local web UI backed by a single binary, with a markdown viewer built in for reading docs along the way.

All data stays local by default. Public sharing is opt-in and tunnels through a relay — no accounts, no sign-up.

npm i -g @peekm/peekm               # install
peekm .                              # start — Claude Code auto-detected

One command. No configuration. AI tracking starts automatically when Claude Code is detected.

Or try without installing: npx @peekm/peekm .

What It Does

AI session tracking (works with Claude Code today):

• Timeline — every AI session across all projects: file edits, conversations, research, debugging. Grouped by day with session duration, tool breakdown, and All/Edits-only filter
• Transcript viewer — read the full AI conversation for any session
• Memory browser — cross-project dashboard of Claude Code's learned context (~/.claude/projects/*/memory/)
• Sharing — share a rendered markdown file with one click. LAN by default (token-scoped URL on your local network) or public via share.peekm.dev (opt-in, HTTPS, 1-hour TTL, auto-expires)
• Smart folders — "Recent AI Edits" surfaces files touched by AI in the last 24 hours
• Toast notifications — appear the instant AI modifies a file, click to navigate
• Session info panel — per-file dropdown showing session ID, tool, permission mode, timestamp
• Persistent history — events survive restarts (~/.peekm/events.jsonl)

Also a markdown viewer:

• VS Code-style sidebar with tree view and fuzzy search (Cmd/Ctrl+P)
• Live reload via Server-Sent Events with event replay
• Light/Dark/Auto themes, persisted
• In-browser editing with auto-save
• HTML export
• Single binary, cross-platform, < 100ms startup

Comparison

	git diff	Git AI	Gryph	claude-code-transcripts	peekm
Real-time notifications	—	—	—	—	Toast + live reload
Visual UI	—	VS Code extension	—	Static HTML	Web UI with tree view
Session correlation	—	Git notes	—	File-based	Per-file session panel
Persistent history	Git log	Git notes	Audit log	JSON files	JSONL timeline
Sharing	—	—	—	—	LAN + public tunnel (opt-in)
Zero config	Yes	Extension install	CLI setup	Post-hoc script	Yes (auto-detects Claude Code)
Free / OSS	Yes	Freemium	Free	Free	Free / MIT

Installation

npm (recommended)

npm i -g @peekm/peekm

Upgrade: npm update -g @peekm/peekm

Try without installing: npx @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 README.md         # view a file
peekm .                 # browse a directory
peekm -port 8080 .      # custom port
peekm -browser=false .  # don't open browser

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

Claude Code integration — peekm automatically configures Claude Code hooks on first run when ~/.claude is detected. No manual setup needed.

Subcommand	Description
peekm setup claude-code	Manually install hooks (auto-setup does this for you)
peekm setup claude-code --port 8080	Custom port
peekm setup claude-code --remove	Remove hooks

Setup is idempotent and non-destructive. Creates ~/.claude/peekm-hook.sh and adds PostToolUse hooks to ~/.claude/settings.json.

Sharing — when viewing a file, click the share button in the top bar.

• LAN (default): a token-scoped URL on your local network is generated and copied to your clipboard. Recipients see a read-only rendered view with live reload.
• Public (opt-in): click "Make public" to tunnel through share.peekm.dev. This gives you an HTTPS URL anyone can open. The link expires after 1 hour. No account or sign-up required. Content transits through the relay while the tunnel is active.

Ignoring Directories

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

target
_site
*.tmp

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

How It Works

1. Track — auto-detects Claude Code and installs PostToolUse hooks to correlate AI session metadata with file changes
2. Discover — scans transcript files to find all sessions, including conversation-only
3. Watch — file changes via fsnotify
4. Notify — SSE with event replay pushes changes to the browser
5. Share — token-scoped URLs expose a single file on the LAN (read-only), with optional public tunneling via relay
6. Parse — markdown to HTML via goldmark
7. Serve — local HTTP server with graceful shutdown

Development

Go 1.23+. go build -o peekm && go test -race ./...

Contributing

PRs welcome. Open an issue if something breaks.

License

MIT — see LICENSE.

Acknowledgments

• goldmark — Markdown parser
• fsnotify — File watching
• chroma — Syntax highlighting
• remotedialer — WebSocket tunneling (public sharing)

Related

• Git AI — Line-level AI attribution via Git notes
• Gryph — CLI audit logger for AI agents
• claude-code-transcripts — Post-hoc HTML transcript viewer
• Vigilo — AI code review guardian