MCPcopy Index your code
hub / github.com/NirDiamant/claude-watch

github.com/NirDiamant/claude-watch @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
145 symbols 300 edges 37 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Claude Watch

See Inside Your AI Coding Sessions

Open-source observability dashboard for Claude Code.

Visualize your project's logic, track changes, and search with AI.

PRs Welcome License: MIT LinkedIn Twitter Discord Sponsor

📫 Stay Updated

🚀 Cutting-edge Updates 💡 Expert Insights 🎯 Top 0.1% Content

Subscribe to DiamantAI Newsletter

Join over 50,000 AI enthusiasts getting unique cutting-edge insights and free tutorials!

DiamantAI's newsletter


Demo

Claude Watch Demo


What It Does

Claude Watch auto-discovers every logic file in your project (system prompts, voice guides, rules, configs, playbooks) and shows them as an interactive visual map.

  • Bubble Graph: your project's brain as a zoomable map. Click to explore.
  • AI Search: ask natural language questions across all your logic files.
  • Live Changes: see what Claude Code is doing in real time.
  • Snapshots: save and restore project state.

Quick Start

# Clone and build
git clone https://github.com/NirDiamant/claude-watch.git
cd claude-watch
npm install && cd dashboard && npm install && cd ..
npm run build

# Start the dashboard
node dist/cli.js start

# In your project directory, set up hooks
node /path/to/claude-watch/dist/cli.js init

Open http://localhost:3853 and use Claude Code normally.

Enable AI Search

export ANTHROPIC_API_KEY=your-key
node dist/cli.js start

How It Works

claude-watch init adds hooks to .claude/settings.json. Every Claude Code tool call gets captured, stored in SQLite, and broadcast to the dashboard via WebSocket.

The brain scanner auto-classifies your project's files by analyzing filenames and content (detecting patterns like NEVER, ALWAYS, MUST, PRIORITY).

CLI

Command Description
claude-watch start Launch dashboard
claude-watch init Set up hooks in current project
claude-watch init --global Set up hooks for all projects
claude-watch snapshot <name> Save project state
claude-watch status Show server stats

Contributing

PRs welcome! Ideas: timeline view, diff viewer, VS Code extension, export to PDF, notifications on rule changes.

License

MIT

Extension points exported contracts — how you extend this code

Project (Interface)
(no doc)
src/types.ts
TreeNode (Interface)
(no doc)
src/services/tree-builder.ts
ServerOptions (Interface)
(no doc)
src/server/index.ts
Project (Interface)
(no doc)
dashboard/src/types.ts
Session (Interface)
(no doc)
src/types.ts
LogicFile (Interface)
(no doc)
src/services/brain-scanner.ts
FileResult (Interface)
(no doc)
src/server/routes/instructions.ts
Session (Interface)
(no doc)
dashboard/src/types.ts

Core symbols most depended-on inside this repo

getDb
called by 25
src/server/db.ts
findNode
called by 6
dashboard/src/components/BrainGraph.tsx
isStructuralSection
called by 4
src/services/tree-builder.ts
isNoiseItem
called by 4
src/services/tree-builder.ts
broadcast
called by 4
src/server/websocket.ts
readTextFile
called by 4
src/server/routes/instructions.ts
toggle
called by 4
dashboard/src/components/InstructionsPanel.tsx
makeSection
called by 3
src/services/tree-builder.ts

Shape

Function 97
Interface 48

Languages

TypeScript100%

Modules by API surface

dashboard/src/components/BrainGraph.tsx15 symbols
src/services/tree-builder.ts13 symbols
dashboard/src/components/BrainPanel.tsx13 symbols
dashboard/src/components/InstructionsPanel.tsx11 symbols
src/services/brain-scanner.ts10 symbols
src/server/routes/instructions.ts9 symbols
dashboard/src/components/BrainTree.tsx9 symbols
src/types.ts7 symbols
src/server/routes/search.ts7 symbols
dashboard/src/types.ts5 symbols
dashboard/src/components/SnapshotPanel.tsx5 symbols
dashboard/src/components/LogicHistory.tsx5 symbols

For agents

$ claude mcp add claude-watch \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page