abanoub-ashraf/hud
hud/SKILL.md
Show or configure the OMX HUD (two-layer statusline)
tools
Updated Mar 26, 2026
$ install --global
skillsauthnpx skillsauth add abanoub-ashraf/manus-skills-import hudInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
70%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 14, 2026, 11:12 PM213.4s1 file scanned
SKILL.md
- name:
- hud
- description:
- Show or configure the OMX HUD (two-layer statusline)
- role:
- display
- scope:
- .omx/**
HUD Skill
The OMX HUD uses a two-layer architecture:
-
Layer 1 - Codex built-in statusLine: Real-time TUI footer showing model, git branch, and context usage. Configured via
[tui] status_linein~/.codex/config.toml. Zero code required. -
Layer 2 -
omx hudCLI command: Shows OMX-specific orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, turns). Reads.omx/state/files.
Quick Commands
| Command | Description |
|---------|-------------|
| omx hud | Show current HUD (modes, turns, activity) |
| omx hud --watch | Live-updating display (polls every 1s) |
| omx hud --json | Raw state output for scripting |
| omx hud --preset=minimal | Minimal display |
| omx hud --preset=focused | Default display |
| omx hud --preset=full | All elements |
Presets
minimal
[OMX] ralph:3/10 | turns:42
focused (default)
[OMX] ralph:3/10 | ultrawork | team:3 workers | turns:42 | last:5s ago
full
[OMX] ralph:3/10 | ultrawork | autopilot:execution | team:3 workers | pipeline:exec | turns:42 | last:5s ago | total-turns:156
Setup
omx setup automatically configures both layers:
- Adds
[tui] status_lineto~/.codex/config.toml(Layer 1) - Writes
.omx/hud-config.jsonwith default preset (Layer 2) - Default preset is
focused; if HUD/statusline changes do not appear, restart Codex CLI once.
Layer 1: Codex Built-in StatusLine
Configured in ~/.codex/config.toml:
[tui]
status_line = ["model-with-reasoning", "git-branch", "context-remaining"]
Available built-in items (Codex CLI v0.101.0+):
model-name, model-with-reasoning, current-dir, project-root, git-branch, context-remaining, context-used, five-hour-limit, weekly-limit, codex-version, context-window-size, used-tokens, total-input-tokens, total-output-tokens, session-id
Layer 2: OMX Orchestration HUD
The omx hud command reads these state files:
.omx/state/ralph-state.json- Ralph loop iteration.omx/state/ultrawork-state.json- Ultrawork mode.omx/state/autopilot-state.json- Autopilot phase.omx/state/team-state.json- Team workers.omx/state/pipeline-state.json- Pipeline stage.omx/state/ecomode-state.json- Ecomode active.omx/state/hud-state.json- Last activity (from notify hook).omx/metrics.json- Turn counts
Configuration
HUD config stored at .omx/hud-config.json:
{
"preset": "focused"
}
Color Coding
- Green: Normal/healthy
- Yellow: Warning (ralph >70% of max)
- Red: Critical (ralph >90% of max)
Troubleshooting
If the TUI statusline is not showing:
- Ensure Codex CLI v0.101.0+ is installed
- Run
omx setupto configure[tui]section - Restart Codex CLI
If omx hud shows "No active modes":
- This is expected when no workflows are running
- Start a workflow (ralph, autopilot, etc.) and check again
Related Skills
abanoub-ashraf/swiftui-design-principles
development
VerifiedTrustedCommunity
Design principles for building polished, native-feeling SwiftUI apps and widgets. Use this skill when creating or modifying SwiftUI views, iOS widgets (WidgetKit), or any native Apple UI. Ensures proper spacing, typography, colors, and widget implementations that look and feel like quality apps rather than AI-generated slop.
SKILL.mdUpdated May 12, 2026
abanoub-ashraf/swiftui-architecture
data-ai
VerifiedTrustedCommunity
Design and implement SwiftUI views, components, and app architecture. Use when creating new SwiftUI views, implementing MVVM/TCA patterns, managing state with @Observable, @State, @Binding, or @Environment, designing navigation flows, or structuring iOS app architecture. Triggers on SwiftUI, view model, state management, navigation, coordinator pattern.
SKILL.mdUpdated May 12, 2026
abanoub-ashraf/swiftui-animation
development
VerifiedTrustedCommunity
Implement, review, or improve SwiftUI animations and transitions. Use when adding implicit or explicit animations with withAnimation, configuring spring animations (.smooth, .snappy, .bouncy), building phase or keyframe animations with PhaseAnimator/KeyframeAnimator, creating hero transitions with matchedGeometryEffect or matchedTransitionSource, adding SF Symbol effects (bounce, pulse, variableColor, breathe, rotate, wiggle), implementing custom Transition or CustomAnimation types, or ensuring animations respect accessibilityReduceMotion.
SKILL.mdUpdated May 12, 2026
abanoub-ashraf/swiftui-accessibility-auditor
testing
VerifiedTrustedCommunity
Audit SwiftUI views for accessibility (iOS + macOS) with patch-ready fixes
SKILL.mdUpdated May 12, 2026