Install Now

npm install -g claudecto

Why claudecto?

You use Claude Code every day. But do you know:

• How much you're spending on tokens?
• Which conversations had the best results?
• What patterns keep showing up across sessions?
• Which skills or hooks would save you hours?

claudecto answers all of this.

Quick Start

npm install -g claudecto
claudecto

That's it. Your dashboard opens at http://localhost:18791.

Features

Search Everything

Full-text search across every Claude conversation you've ever had. Find that one-off fix from three weeks ago in seconds.

claudecto search "authentication middleware"

Analytics & Cost Tracking

See exactly how you use Claude Code: token consumption, cost breakdowns by model, tool usage distribution, and daily activity trends.

AI-Powered Insights

claudecto uses Claude itself to analyze your sessions. Get project health scores, identify code hotspots, spot recurring challenges, and track Claude's effectiveness over time.

Session Browser & Replay

Browse all your sessions with rich metadata — project, branch, timestamps, message count. Open any session to replay the full conversation with syntax-highlighted code blocks.

Skill Studio

Create, edit, and manage Claude Code skills with a visual editor. Includes live preview, validation, and templates to get you started.

Hook Builder

Build event-driven automations with a visual hook editor. Test hooks against real events before deploying them.

AI Advisor

A proactive recommendation engine that analyzes your usage patterns and suggests skills, hooks, CLAUDE.md additions, and MCP servers to improve your workflow.

Multi-Agent Teams

Create teams of specialized agents with leader/teammate roles, generate invocation instructions, and export reusable blueprints.

Tech Stack Intelligence

Aggregates technology usage across all your projects. See patterns, correlations, and get AI-powered insights about your development practices.

Memory Editor

Edit your CLAUDE.md files with 8 project templates (web app, backend, mobile, CLI, monorepo, library, data science, DevOps).

CLI Commands

# Launch the dashboard (default)
claudecto

# Search conversations
claudecto search "fix the auth bug"
claudecto search "API refactor" --project /path/to/project --max 20

# Browse sessions
claudecto sessions
claudecto sessions --project /path/to/project

# Usage statistics
claudecto stats

# List projects
claudecto projects

# Options
claudecto --port 3000          # Custom port
claudecto --no-open            # Don't auto-open browser
claudecto --claude-dir /path

Programmatic API

Use claudecto as a library in your own tools:

import { createServer, ClaudeDir, SessionService, SearchService } from 'claudecto';

// Start the server programmatically
const server = await createServer({ claudeDir: '~/.claude', port: 3000 });
await server.start();

// Or use services directly
const dir = new ClaudeDir('~/.claude');
const sessions = new SessionService(dir);
const { sessions: list } = await sessions.listSessions({ limit: 10 });

REST API

claudecto exposes 50+ API endpoints when the server is running:

| Category | Endpoints | Description | |----------|-----------|-------------| | Stats | GET /api/stats, /api/stats/daily | Usage statistics and daily activity | | Analytics | GET /api/analytics, /api/analytics/daily, /api/analytics/tools | Token/cost tracking, tool distribution | | Sessions | GET /api/sessions, /api/sessions/:id | Browse and read sessions | | Search | POST /api/search | Full-text search | | Skills | GET/POST/PUT/DELETE /api/skills | Skill CRUD | | Hooks | GET/POST/PUT/DELETE /api/hooks, POST /api/hooks/:id/test | Hook management and testing | | Plans | GET /api/plans, /api/plans/:name | Implementation plans | | Insights | GET/POST /api/insights | AI-powered session analysis | | Agents | GET/POST/PUT/DELETE /api/agents, POST /api/agents/generate | Agent management and AI generation | | Teams | GET/POST/PUT/DELETE /api/teams | Multi-agent team orchestration | | Advisor | GET /api/advisor/recommendations, POST /api/advisor/analyze | Proactive recommendations | | Terminal | WS /api/terminal/ws | Integrated Claude Code terminal |

Privacy & Security

• 100% local — All data stays on your machine
• Localhost only — Dashboard binds to 127.0.0.1 by default
• Optional auth — Firebase auth is opt-in for cloud features; client keys are public by design (restricted via Firebase security rules)

Installation

NPM (Recommended)

npm install -g claudecto

Mac App

Download the .dmg from Releases.

From Source

git clone https://github.com/josharsh/openclaudecto
cd claudecto
npm install
npm run build
npm start

Requirements

• Claude Code — Install Claude Code and use it at least once
• Node.js 18+
• macOS 11+ for the desktop app which is coming soon!

Troubleshooting

"Claude directory not found" — Use Claude Code at least once.

Port already in use — claudecto --port 3001

node-pty build errors — The terminal feature requires native compilation:

# macOS
xcode-select --install
# Linux
sudo apt-get install build-essential

Contributing

claudecto will be open source soon!

License

MIT