hud

HUD Skill

Configure the OMC HUD (Heads-Up Display) for the statusline.

Note: All ~/.copilot/... paths in this guide respect COPILOT_CONFIG_DIR when that environment variable is set.

Quick Commands

Command	Description
/oh-my-copilot:hud	Show current HUD status (auto-setup if needed)
/oh-my-copilot:hud setup	Install/repair HUD statusline
/oh-my-copilot:hud minimal	Switch to minimal display
/oh-my-copilot:hud focused	Switch to focused display (default)
/oh-my-copilot:hud full	Switch to full display
/oh-my-copilot:hud status	Show detailed HUD status

Auto-Setup

When you run /oh-my-copilot:hud or /oh-my-copilot:hud setup, the system will automatically:

1. Check if ~/.copilot/hud/omg-hud.mjs exists
2. Check if statusLine is configured in ~/.copilot/settings.json
3. If missing, create the HUD wrapper script and configure settings
4. Report status and prompt to restart Claude Code if changes were made

IMPORTANT: If the argument is setup OR if the HUD script doesn't exist at ~/.copilot/hud/omg-hud.mjs, you MUST create the HUD files directly using the instructions below.

Setup Instructions (Run These Commands)

Step 1: Check if setup is needed:

node -e "const p=require('path'),f=require('fs'),d=process.env.COPILOT_CONFIG_DIR||p.join(require('os').homedir(),'.copilot');console.log(f.existsSync(p.join(d,'hud','omg-hud.mjs'))?'EXISTS':'MISSING')"

Step 2: Verify the plugin is installed:

node -e "const p=require('path'),f=require('fs'),d=process.env.COPILOT_CONFIG_DIR||p.join(require('os').homedir(),'.copilot'),b=p.join(d,'plugins','cache','omc','oh-my-copilot');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));if(v.length===0){console.log('Plugin not installed - run: /plugin install oh-my-copilot');process.exit()}const l=v[v.length-1],h=p.join(b,l,'dist','hud','index.js');console.log('Version:',l);console.log(f.existsSync(h)?'READY':'NOT_FOUND - try reinstalling: /plugin install oh-my-copilot')}catch{console.log('Plugin not installed - run: /plugin install oh-my-copilot')}"