claude-hub 0.3.1

Visual dashboard for managing Claude Code harness configuration

ClaudeHub

Visual dashboard for managing your entire Claude Code configuration.
Skills, Plugins, MCP Servers, Memory, CLAUDE.md — all in one place.

---

What is ClaudHub?

Claude Code stores configuration across dozens of files — settings.json, CLAUDE.md, skills, plugins, hooks, MCP servers, memory, session logs, and more. Managing all of these by hand is tedious and error-prone.

ClaudHub gives you a single visual interface to see, edit, and manage everything in your ~/.claude/ directory. No more guessing what's configured where.

---

Core Features

Dashboard

At a glance, see the full picture of your Claude Code environment.

• Project Harness Status — See which projects have CLAUDE.md, Memory, Settings, Agents, and Commands configured. Spot gaps instantly and launch AI Setup for incomplete projects.
• Extension Summary — Total count of Skills, Plugins, Agents, Hooks, and MCP Servers across your environment.
• Top Used Skills & Plugins — Ranked by actual usage frequency. Identify which tools are driving your workflow.
• Claude Usage — Real-time rate limit monitoring (Session / Weekly / Sonnet), token consumption (Today / Weekly / Monthly), and session counts.
• Auto-refresh — Configurable interval (1m / 3m / 5m / 10m) with manual Sync and Backup History controls.

---

Project Status

Browse all your Claude Code projects and inspect their harness configuration in detail.

• Project List — All projects with session or memory files, showing file count and worktree indicators.
• File Tree — Expand any project to see CLAUDE.md, memory files, docs, and plans with line counts.
• Permission Toggle — Enable or disable all permissions per project.
• Harness Wizard Shortcut — Launch AI-powered configuration directly from the project view.

---

Harness Wizard

Automatically generate optimal Claude Code settings for any project using AI.

• AI-Powered Analysis — Scans your project's code, README, and tech stack, then generates a complete harness configuration based on Anthropic's Official Best Practices.
• Full Harness Generation — Creates CLAUDE.md, Hooks, Permissions, Skills, Agents, Commands, Memory, and MCP configurations in one pass.
• Step-by-Step Flow — Intro → Select Project → Reference Settings → Analyze → Result. Review and apply with confidence.
• Reference-Aware — References your global CLAUDE.md and Memory to maintain consistency across projects.

---

Session History

Browse all Claude Code conversation histories with a chat-style viewer.

• Project Filter — Browse sessions across all projects or filter by specific project.
• Chat-Style Viewer — Read conversations in a familiar message bubble format with tool call indicators.
• Session Metadata — See line count, file size, and timestamps for each session.
• Bulk Management — Select and delete multiple sessions at once.

---

More Features

Context Management

Edit your CLAUDE.md and Memory files with a full-featured code editor.

• Monaco Editor — Syntax-highlighted editing for CLAUDE.md with line numbers.
• Scope Selector — Switch between Global (~/.claude/) and per-project configurations.
• Memory Browser — View and edit project memory files (MEMORY.md, feedback, fixes).
• Context Compare — Diff two projects' configurations side by side and sync with one click.
• Preview Diff — Review changes before saving. Automatic backup on every write.

---

Extensions

Manage Skills, Plugins, Agents, Hooks, and MCP Servers from a single unified view.

• Skills — Browse all installed skills with descriptions and invoke commands. Create custom skills, detect duplicates with similarity scoring.
• Plugins — Toggle, install, and remove plugins.
• Agents — View and edit agent definitions.
• Hooks — Visual editor for all 11 event types.
• MCP Servers — Configure servers with masked environment variables.
• Usage Analysis — AI-powered ranking of extension usefulness based on actual usage patterns.

---

Marketplace

Discover and install plugins and MCP servers from the community.

• Plugin Directory — Browse 100+ plugins from official and community sources.
• MCP Servers — Install MCP servers with automatic settings.json configuration.
• Category Filters — Filter by automation, database, deployment, design, development, and more.
• One-Click Install/Uninstall — No manual JSON editing required.

---

Templates

Apply pre-built harness configurations to any project with one click.

• Community Templates — Built-in presets for React, FastAPI, Next.js, Monorepo, Data Science, and more.
• My Templates — Export your own project configurations as reusable templates.
• Template Details — See hooks, MCP servers, and CLAUDE.md line counts before applying.

---

Installation

Homebrew (macOS, recommended)

brew tap WontaeKim89/tap && brew install claude-hub

After installation, start the server:

claude-hub

Update to the latest version:

brew update && brew upgrade claude-hub

PyPI

uvx claude-hub          # one-shot run (no install)
# or
pip install claude-hub   # permanent install
claude-hub

From Source

git clone https://github.com/WontaeKim89/claude-hub.git
cd claude-hub
bash scripts/build.sh   # Build frontend
uv run claude-hub        # Start server

Opens at http://localhost:3847

macOS Native App (optional)

bash scripts/macos/create-app.sh
# Launches from Spotlight — menu bar tray stays active

Prerequisites

• Python 3.13+
• Node.js 18+ (for frontend build)
• uv (Python package manager)
• Claude Code installed and authenticated

---

Tech Stack

Layer	Technology
Backend	Python 3.13 / FastAPI / Pydantic v2 / uvicorn
Frontend	Vite + React 19 + Tailwind CSS v4 + Monaco Editor
Database	SQLite (usage statistics)
Packaging	PyPI (uv build)
macOS App	AppleScript bundle + LaunchAgent

---

Design Principles

• Local-only — Binds to 127.0.0.1. Your config never leaves your machine.
• Non-destructive — Automatic backup before every write operation.
• Conflict-safe — mtime-based optimistic locking (409 on concurrent edits).
• Zero config — Reads ~/.claude/ filesystem directly, no setup required.
• Bilingual — KO/EN language support.

---

Development

# Backend (auto-reload)
uv run uvicorn claude_hub.main:create_app --factory --reload --port 3847

# Frontend (dev server with HMR)
cd src/client && npm run dev

# Tests
uv run pytest tests/ -v

---

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

---

License

MIT License. See LICENSE for details.