Che Dashboard Agent

che-dashboard-agent

A containerized AI coding assistant for the Eclipse Che Dashboard's Devfile Creator. Runs [Claude Code](https://claude.ai/claude-code) inside a [ttyd](https://github.com/tsl0922/ttyd) web terminal (xterm.js + WebSocket), embedded in the dashboard UI via an iframe.

What it does

When a user creates a devfile in the Che Dashboard, they can start an AI agent that helps author and edit the devfile. The dashboard backend creates a dedicated Pod + ClusterIP Service for the agent (not a DevWorkspace). The agent communicates with the dashboard through a web terminal proxied over WebSocket.

The agent can also assist with troubleshooting DevWorkspace startup failures — diagnosing pod events, container logs, and patching DevWorkspace specs via the Kubernetes API.

Repository Structure

Path	Description
dockerfiles/Dockerfile	Multi-stage build: downloads Claude Code binary + ttyd + kubectl, produces a minimal scratch image
scripts/collect-rootfs.sh	Collects minimal rootfs for the scratch image (binaries, shared libs, glibc compat stubs, wrapper scripts)
settings/settings.json	Claude Code configuration (model selection, enabled plugins)
settings/claude.json	Onboarding state: skips first-run wizard and startup tips
CLAUDE.md	Base system prompt: role, mandatory container args rule, blocked commands, environment variables
plugin/	Claude Code plugin with two contextual skills (see Agent Skills)
devfile.yaml	Reference devfile for standalone testing (not used by the dashboard backend)
Makefile	Build, push, run, and smoke-test targets

Architecture

Dashboard UI (iframe)
    |
    v  HTTP proxy (in-cluster)
Dashboard Backend (agents.ts)
    |
    v  in-cluster WebSocket
ttyd (port 8080)
    |
    v  PTY
Claude Code CLI (/usr/local/bin/claude)
    |
    v  Kubernetes API (user token)
ConfigMap "devfile-creator-storage"

Build and Push

#