Skip to content
Skills Library
Personal productivity · Automation

sync-theme

/sync-theme

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.

Licence
MIT
Last repository change
23.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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.

Original author 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.

How it works

  1. Automatic switching (one-time setup)
Original SKILL.md headings · 41 lines, 237 words
SKILL.md preview
---
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
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]`):

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

Versions

The database has no other skills named sync-theme.

Database snapshot: 13.11.2026 · package version bc99de7aa7b4 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95theme-elements
    Install theme switcher components from the Elements registry. Use when user needs dark mode toggles, theme switchers, light/dark buttons, or theme dropdowns. Triggers on "theme switcher", "dark mode", "light mode", "theme toggle", "theme button", "switch theme", "dark mode toggle".
  • 100desktop-skin
    Make a custom skin for the Claude desktop app on macOS: a colour theme from someone's palette or brand, painted into every window at launch, plus a name badge above the Claude Code prompt. Use when someone asks to theme, skin, recolour or brand their Claude app, or wants their…
  • 95light-dark-mode
    Load this skill whenever the project supports light/dark mode, colour theme switching, high-contrast mode, or responds to prefers-color-scheme. Under no circumstances hard-code colours that break in alternative themes. Absolutely always test colour contrast in both light and…
  • 100pptx-dark-vs-light-themes
    Use this skill when deciding between dark and light theme presentation canvases based on room lighting, display hardware, and executive context.
  • 100fused-render-theming
    Use when fused-render view must follow app light/dark, or looks wrong in opposite theme.
  • 100theme-factory
    Create new AiderDesk UI themes by defining SCSS color variables, registering theme types, and adding i18n display names. Use when adding a theme, creating a color scheme, customizing appearance, or implementing dark mode and light mode variants.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.