project-view

Launch the cmux Workshop dashboard with dependency checks and React build.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/merong/cmux-workshop --skill project-view
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-view
Source: https://github.com/merong/cmux-workshop/tree/main/plugins/cmux-workshop/skills/project-view
Command: npx skills add https://github.com/merong/cmux-workshop --skill project-view

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires redis-cli, node, cmux, curl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Launching and managing the cmux Workshop project view within Claude Code is complex: it requires dependency checks, port reclamation, building the React bundle, and orchestrating a background Node/Express server that serves a vendored UI and streams hook events.

Core Features & Use Cases

  • Dependency verification and port management to ensure the dashboard starts cleanly.
  • Automatic build of the vendored React UI and a background server that serves REST and WebSocket streams.
  • Idempotent startup that reopens the dashboard if it is already running, with optional cmux metadata enrichment when available.
  • Quick access to the project view dashboard via a sentinel status and automatic launching in the default browser.

Quick Start

Run the project-view startup script to launch the dashboard.

Frequently Asked Questions about project-view

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch the project view dashboard for cmux workflows in one step?

To launch the project view dashboard, run the startup script which performs dependency checks, port reclamation, React build, and background server startup to expose a ready-to-use dashboard for Claude Code workflows.

What dependencies do I need to run the cmux Workshop project view?

You need redis-cli, node, cmux, and curl installed to run the project view. The startup script verifies these dependencies during its environment readiness check before building the React UI.

How does the project view dashboard handle port conflicts during startup?

The project view startup script performs port reclamation to ensure the dashboard starts cleanly. This resource management step clears conflicting ports before launching the background Node/Express server.

Can I restart the project view dashboard without losing my current session?

Yes, the project view supports idempotent startup that reopens the dashboard if it is already running. It safely reinitializes the background server and streams hook events without disrupting your active Claude Code workflow.

Does the project view dashboard support real-time hook event streaming?

Yes, the project view serves REST and WebSocket interfaces for real-time hook events. The background Node/Express server streams these events directly to the vendored React UI dashboard.

What happens if cmux metadata is unavailable when launching the project view?

The project view launches normally without cmux metadata. The startup routine applies optional cmux metadata enrichment only when available, ensuring the dashboard remains fully operational regardless of cmux status.