Create Plugin

Build an oh-my-claude statusline plugin — from idea to working output in one pass.

Workflow

1. Clarify the plugin's purpose — ask what it should display, when to hide, and any config the user wants. See PATTERNS.md for data fields and common patterns.

2. Choose plugin type — JS plugin (default, in-process, fast) or script plugin (any language, runs as subprocess). Use JS unless the user specifies a language or the task needs external tools. See PATTERNS.md.

3. Scaffold the plugin — run omc create <name> (or omc create <name> --script --lang=python|bash). This creates the directory structure at ~/.claude/oh-my-claude/plugins/<name>/.

4. Implement render logic — edit the generated plugin.js (or plugin script). Follow the contract in PATTERNS.md. Always use optional chaining. Always return null when data is missing.

5. Set default config — add any configurable values to meta.defaultConfig (JS) or plugin.json (script). Use concrete defaults, not empty strings.

6. Test the plugin — run omc test <name>. Verify it returns { text, style } with mock data and returns null with empty data.

7. Wire it up — run omc add <name> (with --line N and --left if needed). Run omc show to verify placement.