@zilliz/claude-context-dashboard

Terminal dashboard for monitoring Claude Context indexing progress in real-time.

Installation

# Using npm
npm install -g @zilliz/claude-context-dashboard

# Using pnpm
pnpm add -g @zilliz/claude-context-dashboard

# Or run directly with npx
npx @zilliz/claude-context-dashboard

Usage

# Run with defaults (1 second refresh)
claude-context-dashboard

# Custom refresh interval (500ms)
claude-context-dashboard --refresh 500

# Custom snapshot file path
claude-context-dashboard --path /path/to/snapshot.json

# Show help
claude-context-dashboard --help

Features

• Real-time progress tracking - Watch indexing progress update automatically
• Multiple codebase support - Monitor all codebases being indexed simultaneously
• Status indicators - Visual badges for indexing/indexed/failed states
• Progress bars - Animated progress bars for active indexing operations
• Cross-platform - Works on Windows, macOS, and Linux

Keyboard Controls

• q - Quit the dashboard
• Ctrl+C - Exit

Screenshot

+-------------------------------------------------------------+
| Claude Context Dashboard                                     |
| Snapshot: C:\Users\user\.context\mcp-codebase-snapshot.json |
| Last refresh: 14:32:15                                       |
+-------------------------------------------------------------+

Codebases: 1 indexing | 2 completed | 0 failed

+-----------------------------------------------------------+
| C:\Projects\my-app                          [ INDEXING ]  |
| [========================================>         ] 78.5%|
| Updated: just now                                          |
+-----------------------------------------------------------+

+-----------------------------------------------------------+
| C:\Projects\backend                         [  INDEXED  ] |
| Files: 1,234  Chunks: 45.6K                                |
| Updated: 5m ago                                            |
+-----------------------------------------------------------+

+-----------------------------------------------------------+
| Press q to quit | Auto-refresh: 1s                         |
+-----------------------------------------------------------+

How It Works

The dashboard reads the snapshot file created by the Claude Context MCP server:

• Default location: ~/.context/mcp-codebase-snapshot.json
• Updates every 2 seconds during indexing
• Persists progress across MCP server restarts

Development

# Clone the repository
git clone https://github.com/zilliztech/claude-context.git
cd claude-context

# Install dependencies
pnpm install

# Run in development mode
pnpm dev:dashboard

# Build
pnpm build:dashboard

License

MIT