Overview

The debug-daemon command connects to a running workstation process and reports its current state. Use it when the workstation is running but behaving unexpectedly.

npx ticket-house debug-daemon

What It Reports

  • Process status — uptime, memory usage, PID
  • Active worktrees — list of tracked worktrees with their ticket IDs and branch names
  • Container pool — running containers, idle slots, pending builds
  • Server connection — connection state to the remote server, last heartbeat time
  • MCP server — whether the MCP server is accepting connections
  • Dev Watch — if configured, the current state of the dev process and symlinks

When to Use It

  • Worktrees aren't appearing in the web UI
  • AI agents can't connect via MCP
  • Containers aren't being provisioned
  • The workstation appears frozen or unresponsive

As a Claude Skill

The debug-daemon command is also available as a Claude skill. When an AI agent encounters issues with the workstation, it can run the debug-daemon skill to diagnose the problem and report findings. See Writing Claude Skills for more.