whatisgithub

What is claude-code-dashboard?

kevin101681/claude-code-dashboard — explained in plain English

Analysis updated 2026-05-18

10JavaScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A self hosted web dashboard that lets you run, monitor, and control Claude Code and Codex CLI sessions on your own PC from any browser, including your phone.

Mindmap

mindmap
  root((Claude Dashboard))
    What it does
      Remote control panel
      Runs Claude Code and Codex
      Persistent PC sessions
    Tech stack
      Node.js
      Express
      WebSocket
    Use cases
      Monitor coding agents remotely
      Approve prompts from phone
      Run persistent PowerShell sessions
    Audience
      Developers
    Setup
      Windows PC
      Node.js 18 plus
      Existing CLI subscriptions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Start a Claude Code or Codex coding session on your PC and check on it later from your phone.

USE CASE 2

Approve AI agent permission prompts remotely without needing to be at your desktop.

USE CASE 3

Run persistent PowerShell sessions on your PC through the same dashboard interface.

What is it built with?

Node.jsJavaScriptExpressWebSocketxterm.js

How does it compare?

kevin101681/claude-code-dashboardaetherwing-io/keystrokesagi-ruby/ai-gpt_image2-seedance_2.0-video-skills
Stars101010
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderateeasy
Complexity3/52/51/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+, Windows, and Claude Code (and optionally Codex) already installed and signed in.

No formal license section is stated in the README beyond a brief no warranty note.

So what is it?

Claude Dashboard is a self hosted control panel that lets you run and monitor Claude Code and OpenAI Codex, two AI coding assistants that normally live in a terminal, from any device with a web browser, including a phone. The actual work happens on your own Windows PC, which keeps running the AI agent sessions even after you close the browser tab, so you can start a task from your desktop, check its progress from your phone, and approve a permission prompt from anywhere else, then pick the same session back up later with its full history intact. There is no cloud service sitting in between and no per use API charges, since the dashboard runs the Claude Code and Codex command line tools you already have installed, using your existing subscriptions to those services. You can view a session either as a simplified chat style conversation or switch to the real underlying terminal when you need to see a raw permission prompt or a text based menu. Push notifications can alert you when a session finishes or needs your input, but only when you are not already looking at the dashboard, and tapping the notification opens that exact session. Each session also has its own permission setting you can change on the fly, so one task can run with fewer restrictions while another stays locked down. Because these AI agents can read files, run commands, and reach the network on your behalf, sometimes without asking first depending on the permission mode chosen, the README treats access to this dashboard as equivalent to a key to your whole computer. It recommends keeping it reachable only over a private network such as Tailscale rather than exposing its port to the internet, and setting a long random access token, or using a sign in service called Clerk if exposed more broadly. It also warns that an AI agent can be influenced by untrusted text it reads, such as a poisoned file or web page, so approvals should stay on for anything not fully trusted. Setting it up locally on Windows is a short sequence of installing dependencies, copying an example configuration file, setting an access token, and starting the server. The project has no build step, no framework, and no database, and the author describes it as small enough to read through in an afternoon.

Copy-paste prompts

Prompt 1
Walk me through installing and running this dashboard for the first time on my Windows PC.
Prompt 2
Explain how to set up Tailscale so I can reach this dashboard securely from my phone.
Prompt 3
Show me the difference between the permission modes this dashboard supports.
Prompt 4
Explain the security risks this README describes and how to reduce them before exposing this dashboard.

Frequently asked questions

What is claude-code-dashboard?

A self hosted web dashboard that lets you run, monitor, and control Claude Code and Codex CLI sessions on your own PC from any browser, including your phone.

What language is claude-code-dashboard written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript, Express.

What license does claude-code-dashboard use?

No formal license section is stated in the README beyond a brief no warranty note.

How hard is claude-code-dashboard to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-code-dashboard for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.