hud

Display Forge orchestration HUD and Kronon status line from .forge state files.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/lpjhelder/kronon-forge --skill hud-lpjhelder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/lpjhelder/kronon-forge/tree/main/skills/hud
Command: npx skills add https://github.com/lpjhelder/kronon-forge --skill hud-lpjhelder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The HUD centralizes Forge and Kronon runtime state so users can quickly see model, branch, workflow modes, worker counts, and recent activity without inspecting multiple state files or running many commands.

Core Features & Use Cases

  • Two-layer display combining Kronon built-in status line for model and context information with the Forge CLI HUD for orchestration state.
  • Real-time monitoring and scripting via a watch mode and machine-readable JSON output, plus configurable presets for minimal, focused, or full displays.
  • Use Case: When running automated workflows, use the HUD to monitor ralph loop progress, ultrawork and autopilot phases, team worker counts, pipeline stage, and turn metrics in one glance.

Quick Start

Run the forge hud command to show the current HUD, use --watch for live updates, or use --json to output machine-readable state for automation.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I monitor Forge orchestration state during automated workflows?

Use the `forge hud` command to monitor Forge orchestration state and Kronon status line. It reads `.forge/state` JSON files and `.forge/hud-config.json` to surface model, branch, workflow modes, worker counts, and recent activity in a two-layer display.

What is the Forge HUD used for in Kronon CLI development?

The Forge HUD centralizes Forge and Kronon runtime state to monitor model, branch, workflow modes, worker counts, and recent activity. It combines the Kronon built-in status line with the Forge CLI HUD to avoid inspecting multiple state files or running many commands.

Can I output Forge orchestration state as JSON for scripting and automation?

Yes, you can output machine-readable Forge orchestration state as JSON by running `forge hud --json`. This provides state data for scripting and tooling integration, surfacing ralph loop progress, autopilot phases, team worker counts, pipeline stage, and turn metrics.

How do I get live updates of Kronon status line and Forge workflow metrics?

To get live updates of Kronon status line and Forge workflow metrics, run `forge hud --watch`. This enables real-time monitoring of ralph, ultrawork, autopilot, team, pipeline, and turn metrics during development and runtime operations.

Does the Forge HUD support configurable display presets for monitoring orchestration?

Yes, the Forge HUD supports configurable presets for minimal, focused, or full displays when monitoring orchestration. These presets are configured via `.forge/hud-config.json` and integrate with Kronon `tui` status_line configuration to customize the two-layer display.