convez.ai
InicialPluginScore · de 0 a 100

Real-time dashboard for AI coding sessions. Track every file edit, read full AI conversations, and browse learned context across all your projects. Single binary, zero config, all data local. Works with Claude Code today.

Instalação

$npx convez-ai razvandimescu/peekm

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
v0.1.35
Issues abertas
3
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

peekm

See what every Claude Code session is doing across all your projects — live, not after the fact.

GitHub stars Go Report Card GitHub Release License

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

peekm — watching a live Claude Code session across multiple projects

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

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); Markdown shares offer one-click DOCX download
  • File viewer — VS Code-style sidebar with Markdown, HTML, SVG, and TXT support. Fuzzy search (Cmd/Ctrl+P), in-browser editing (Markdown), Mermaid diagram rendering, 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 registers a PostToolUse hook with Claude Code so it can correlate file edits with the session that made them. Setup runs automatically on first launch when ~/.claude exists.

What setup does:

  • Creates ~/.claude/peekm-hook.sh — the hook script that fires after each Claude Code tool call.
  • Adds an entry to ~/.claude/settings.json under hooks.PostToolUse — non-destructive merge; existing hooks are preserved, and re-running setup is idempotent.
  • Captures events to ~/.peekm/events.jsonl — appended even when peekm isn't running, so no sessions are lost.

What the hook sends: session ID, file path, and tool name — no file contents, no prompts, no model output. Posted to 127.0.0.1:6419 only. No data leaves your machine unless you opt into public sharing.

To remove: peekm setup claude-code --remove strips the entry from settings.json and deletes the hook script.

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.

FlagDefaultDescription
-port6419Port to serve on
-browsertrueAuto-open browser
-no-ai-trackingfalseDisable 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.
  • DOCX download: shared Markdown views include a one-click DOCX export for recipients.

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.

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 & Limits

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

Scope today: Claude Code only. Tracks PostToolUse hooks (file edits and tool calls), not the model's internal reasoning. Single-machine — no team or multi-machine sync.

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 .

Ver o original no GitHub

Bom para

Relacionados