Skip to content

TadMSTR/cloudcli-plugin-helm-dashboard

Repository files navigation

cloudcli-plugin-helm-dashboard

A CloudCLI tab plugin that surfaces the Helm platform dashboard — agent sessions, memory files, knowledge graph, infrastructure health, build progress, handoffs, and Plane work items — as a first-class tab in the CloudCLI UI.

Panels

Panel What It Shows
Agents All Claude Code agent projects with session counts and last-active timestamps
Memory Working memory files across shared and per-agent tiers with expiry status
Handoffs Cross-agent handoff artifacts — source, target, status
Graph Graphiti knowledge graph query results (recent facts and node search)
Infra Task queue depth, build plans, security audit queue, active PM2 services
Build Helm build plan phases and active Temporal workflow state
Plane HELM project work items from Plane — modules, cycles, open issues

Live updates arrive over WebSocket. The plugin server polls claudebox state (project dirs, memory files, task queue) and pushes deltas to connected clients on change.

Architecture

CloudCLI tab slot
  └── dist/index.js          — Frontend plugin (TypeScript → ESM, esbuild)
  └── dist/server.js         — Backend server (Node.js, WebSocket + HTTP)
        ├── Reads ~/.claude/projects/, ~/.claude/memory/, ~/.claude/task-queue/
        ├── GraphitiClient    — Graphiti REST API (knowledge graph queries)
        ├── PlaneClient       — Plane REST API (HELM project work items)
        └── NtfyClient        — ntfy (notifications passthrough)

Installation

# Build
npm install
npm run build

# Deploy via CloudCLI plugin manifest
# The manifest.json registers this as a tab plugin:
#   slot: "tab", entry: "dist/index.js", server: "dist/server.js"
bash deploy.sh

Development

npm run dev   # TypeScript watch mode

The server reads environment from the CloudCLI host process. No additional configuration required for local claudebox use.

Requirements

  • Node.js 20+
  • CloudCLI running on claudebox
  • Graphiti MCP server accessible (for graph panel)
  • Plane API token in environment (for Plane panel)

Notes

This plugin is private and scoped to claudebox. It reads local filesystem paths directly and is not designed for multi-host or remote use.

About

A CloudCLI tab plugin that surfaces the Helm platform dashboard — agent sessions, memory files, knowledge graph, infrastructure health, build progress, handoffs, and Plane work items — as a first-class tab in the CloudCLI UI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors