sync-theme

name	sync-theme
description	Manually sync the editor theme to the current macOS appearance (light/dark). Use when the user switched macOS appearance and wants Claude Code and/or Codex themes refreshed now, or asks to fix/resync the theme. Light → gruvbox-light, dark → sunset-drive.
version	0.1.0

Auto Theme — manual sync

This plugin keeps editor themes in step with the macOS system appearance (light/dark). Switching is normally automatic via a UserPromptSubmit hook; this skill is the on-demand trigger.

Run the bundled script. It detects the macOS appearance and sets both editors:

• Claude Code — ~/.claude/settings.json theme (light → custom:gruvbox-light, dark → custom:sunset-drive)
• Codex — ~/.codex/config.toml [tui] theme (light → gruvbox-light, dark → sunset-drive)

It also installs the bundled themes on first run (~/.claude/themes/, ~/.codex/themes/) if absent.

Execution & Communication Rules:

1. First, check if the host OS is Darwin (macOS). If not, refuse to run and output: Error: Host environment is not macOS.
2. Run the bash command. Ensure you capture stderr.
3. Run the script and surface any WARN: lines from stderr exactly as emitted.
4. Treat WARN: <path> malformed, skipped and WARN: <path> not writable as script-reported configuration problems; do not invent different error text.
5. Response Format: Output a 2-line bulleted summary detailing: Line 1: Detected OS appearance, Line 2: The exact themes written to both files. Do not include conversational filler.

bash "${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT}}/sync-theme.sh"

Automatic switching (one-time setup)

Codex plugins cannot declare hooks in their manifest, so register the hook once in ~/.codex/hooks.json (then trust it via ~/.codex/config.toml [hooks.state]):

{
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": [ { "type": "command", "command": "bash '<plugin-root>/sync-theme.sh'", "timeout": 10 } ] }
    ]
  }
}