hud

Files (1)

• SKILL.md

SKILL.md (first lines)

# HUD Skill

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

Note: All `~/.codex/...` paths in this guide respect `CODEX_CONFIG_DIR` when that environment variable is set.

## Quick Commands

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

## Auto-Setup

When you run `/oh-my-codex:hud` or `/oh-my-codex:hud setup`, the system will automatically:
1. Check if `~/.codex/hud/omc-hud.mjs` exists
2. Check if `statusLine` is configured in `~/.codex/settings.json`
3. If missing, create the HUD wrapper script and configure settings
4. Report status and prompt to restart Codex if changes were made

**IMPORTANT**: If the argument is `setup` OR if the HUD script doesn't exist at `~/.codex/hud/omc-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:
```bash
ls ~/.codex/hud/omc-hud.mjs 2>/dev/null && echo "EXISTS" || echo "MISSING"
```

**Step 2:** Verify the plugin is installed:
```bash
PLUGIN_VERSION=$(ls ~/.codex/plugins/cache/omc/oh-my-codex/ 2>/dev/null | sort -V | tail -1)
if [ -n "$PLUGIN_VERSION" ]; then
  ls ~/.codex/plugins/cache/omc/oh-my-codex/$PLUGIN_VERSION/dist/hud/index.js 2>/dev/null && echo "READY" || echo "NOT_FOUND - try reinstalling: /plugin install oh-my-codex"
else
  echo "Plugin not installed - run: /plugin install oh-my-codex"
fi
```

**Step 3:** If omc-hud.mjs is MISSING or argument is `setup`, create the HUD directory and script:

First, create the directory:
```bash
mkdir -p ~/.codex/hud
```

Then, use the Write tool to create `~/.codex/hud/omc-hud.mjs` with this exact content:

```javascript
#!/usr/bin/env node
/**
 * OMC HUD - Statusline Script
 * Wrapper that imports from plugin cache or development paths
 */

import { existsSync, readdirSync } from "node:fs";
import { homedir } from "node:os";
import { join } from "node:path";
import { pathToFileURL } from "node:url";

// Semantic version comparison: returns negative if a < b, positive if a > b, 0 if equal
function semverCompare(a, b) {
  // Use parseInt to handle pre-release suffixes (e.g. "0-beta" -> 0)
  const pa = a.replace(/^v/, "").split(".").map(s => parseInt(s, 10) || 0);
  const pb = b.replace(/^v/, "").split(".").map(s => parseInt(s, 10) || 0);
  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
    const na = pa[i] || 0;
    const nb = pb[i] || 0;
    if (na !== nb) return na - nb;
  }
  // If numeric parts equal, non-pre-release > pre-release
  const aHasPre = /-/.test(a);
  const bHasPre = /-/.test(b);
  if (aHasPre && !bHasPre) return -1;
  if (!aHasPre && bHasPre) return 1;
  return 0;
}

async function main() {
  const home = homedir();
  let pluginCacheDir = null;

  // 1. Try plugin cache first (marketplace: omc, plugin: oh-my-codex)
  const pluginCacheBase = join(home, ".codex/plugins/cache/omc/oh-my-codex");
  if (existsSync(pluginCacheBase)) {
    try {
      const versions = readdirSync(pluginCacheBase);
      if (versions.length > 0) {
        const latestVersion = versions.sort(semverCompare).reverse()[0];
        pluginCacheDir = join(pluginCacheBase, latestVersion);
        const pluginPath = join(pluginCacheDir, "dist/hud/index.js");
        if (existsSync(pluginPath)) {
          await import(pathToFileURL(pluginPath).href);
          return;
        }
      }
    } catch { /* continue */ }
  }

  // 2. Development paths
  const devPaths = [
    join(home, "Workspace/oh-my-codex/dist/hud/index.js"),
    join(home, "workspace/oh-my-codex/dist/hud/index.js"),
    join(home, "Workspace/oh-my-codex/dist/hud/index.js"),
    join(home, "workspace/oh-my-codex/dist/hud/index.js"),
  ];

  for (const devPath of devPaths) {
    if (existsSync(devPath)) {
      try {
        await import(pathToFileURL(devPath).href);
        return;
      } catch { /* continue */ }
    }

From realsigridjin/oh-my-codex, MIT.

More from realsigridjin/oh-my-codex