hud

Files (1)

• SKILL.md

SKILL.md (first lines)

# HUD Skill

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

## Quick Commands

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

## Auto-Setup

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

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

**Step 2:** Check if the plugin is built (CRITICAL - common issue!):
```bash
# Resolve the active install from Factory's plugin metadata
PLUGIN_DIR=$(node --input-type=module - <<'NODE'
import { readFileSync } from "node:fs";
import { homedir } from "node:os";
import { join } from "node:path";

const registries = [
  { path: join(process.cwd(), ".factory/plugins/installed_plugins.json"), scope: "project" },
  { path: join(homedir(), ".factory/plugins/installed_plugins.json"), scope: "user" },
];
for (const registry of registries) {
  try {
    const metadata = JSON.parse(readFileSync(registry.path, "utf-8"));
    const installs = metadata.plugins?.["oh-my-droid@oh-my-droid"] ?? [];
    const install = installs.find((item) => item.scope === registry.scope) ?? installs[0];
    if (install?.installPath) {
      console.log(install.installPath);
      process.exit(0);
    }
  } catch {}
}
console.log("");
NODE
)
if [ -n "$PLUGIN_DIR" ]; then
  test -f "$PLUGIN_DIR/dist/hud/index.js" && echo "BUILT" || echo "NOT_BUILT"
fi
```

**⚠️ CRITICAL: If NOT_BUILT, the plugin MUST be compiled before the HUD can work!**

**WHY THIS HAPPENS:** The `dist/` directory contains compiled TypeScript code
and is not stored on GitHub. It is normally generated by the package's
`prepare` script during `npm install`. If lifecycle scripts did not run or the
build failed, the HUD bundle will be missing.

**THE FIX:** Run npm install in the plugin directory to build it:
```bash
cd "$PLUGIN_DIR" && npm install
```

This will:
1. Install all dependencies
2. Run the `prepare` script which executes `npm run build`
3. Generate the `dist/hud/index.js` file that the HUD wrapper needs

**DO NOT** try to download `dist/hud/index.js` from GitHub raw URLs - it doesn't exist there!

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

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

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

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

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

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

  // 1. Resolve the active plugin install from Factory metadata
  const pluginRegistries = [
    {
      path: join(process.cwd(), ".factory/plugins/installed_plugins.json"),
      scope: "project",
    },
    {
      path: join(home, ".factory/plugins/installed_plugins.json"),
      scope: "user",
    },
  ];
  for (const registry of pluginRegistries) {

From MeroZemory/oh-my-droid, MIT.

More from MeroZemory/oh-my-droid