Claude Code Dashboard is a desktop GUI for managing your Claude Code environment: MCP servers, Skills, Plugins, Sub-agents, and project configurations.
No compilation needed — just download the
.dmg, drag to Applications, and launch. Requires Claude Code installed (npm install -g @anthropic-ai/claude-code)
Claude Code has quickly become the most powerful AI coding assistant available — but it's a terminal-based tool. For developers, that's natural. For everyone else — content creators, project managers, marketers, entrepreneurs — the terminal is a wall.
Claude Code can do incredible things beyond coding: write editorial plans, manage emails, search the web, analyze documents, automate workflows. But none of that matters if people can't get past the terminal prompt.
Claude Code Dashboard breaks that wall. It wraps Claude Code in a familiar, visual interface:
- A chat mode that feels like WhatsApp — type a message, get a response, no terminal knowledge needed
- Permission approval buttons — when Claude wants to edit a file, you tap Approve or Reject
- Mobile control via Telegram — manage Claude Code from your phone
- A full dashboard for developers to manage MCP servers, plugins, agents, and configurations
The goal is simple: make Claude Code accessible to everyone, not just developers.
Launcher — Launch Claude Code, manage tmux sessions, view environment summary
Embedded Terminal — Claude Code on top, shell on bottom, with tmux split panes
Health Check — Real-time MCP server connection status
Settings — Theme, language, launch mode, tmux, Telegram bot configuration
- MCP Manager - View cloud connectors (claude.ai) and manage local MCP servers (CRUD)
- Skills & Plugins - Browse installed plugins with enable/disable toggle, view skills from plugins, custom skills, and project-local skills
- Sub-agents - View plugin agents, edit custom user agents (.md files), manage config-based agents
- Context Switcher - Switch between Global and Project scope with recent projects from Claude session history
- Chat Mode - Chat-like interface for non-technical users with Markdown rendering, image upload, and persistent history
- Embedded Terminal - Full xterm.js terminal with tmux support for persistent sessions
- tmux Split Panes - Claude Code on top, shell on bottom, with visual separator and mouse resize
- External Terminals - Support for Terminal, iTerm2, Warp, Alacritty, or custom
- Permission Approval - PTY-based chat forwards Claude's permission requests as Approve/Reject buttons
- Telegram Bot - Control Claude Code from your phone with inline keyboard buttons
- Session Memory - Telegram conversations maintain context across messages
- Session Switching -
/sessions,/switch,/newcommands with tappable buttons
- Cmd+K Command Palette - Quick navigation and tmux session switching
- i18n - Full Italian/English localization
- System Tray - Background operation with tray icon
- Dark/Light/System theme
| Layer | Technology |
|---|---|
| Desktop Framework | Tauri 2 (Rust + WebView) |
| Frontend | React 18 + TypeScript |
| UI Components | shadcn/ui (base-ui) |
| Styling | Tailwind CSS v4 |
| State Management | Zustand |
| Terminal | xterm.js + portable-pty |
| Build | Vite |
# Prerequisites
# - Rust (rustup)
# - Node.js >= 18
# - Claude Code installed (npm install -g @anthropic-ai/claude-code)
# Clone
git clone https://github.com/tommasinigiovanni/ClaudeCodeDashboard.git
cd ClaudeCodeDashboard
# Install dependencies
npm install
# Dev mode
npm run tauri dev
# Production build
npm run tauri build| File | Description |
|---|---|
~/.claude/settings.json |
Global configuration |
project/.claude/settings.local.json |
Project configuration |
~/.claude/agents/*.md |
Custom agents |
~/.claude/skills/*/SKILL.md |
Custom skills |
~/.claude/commands/*.md |
Custom slash commands |
~/.claude/plugins/ |
Installed plugins |
- Create a bot with @BotFather on Telegram
- Copy the bot token
- Go to Settings in the dashboard, paste the token
- Click Start Telegram bot
- Send
/chatidto your bot to get your Chat ID (optional, for security) - Start chatting with Claude Code from your phone!
Commands: /menu, /sessions, /switch <project>, /new, /help
Full documentation is available in the app under the Documentation page, in both Italian and English.
| File | Content |
|---|---|
PRD.md |
Product requirements |
ARCHITECTURE.md |
Technical architecture |
DATA_MODEL.md |
Data model and config structure |
TASKS.md |
Development task breakdown |
Apache 2.0 - Use, modify and share freely!
Made with love by Giovanni Tommasini in pair programming with Claude Code (Opus 4.6)