SF2THEMES

SETUP + APPLY

INSTALL

Run the CLI directly from GitHub with uv, then set up each terminal once. Use short catalog ids such as ken on the CLI; installed theme identities use the grouped sf2-ken form in every adapter.

GET THE CLI

uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes --version

Requires uv and Python 3.11 or newer.

MAKE YOUR MOVE

01 - WEZTERM
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes setup wezterm

Set up the one-time WezTerm integration.

02 - WEZTERM
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes apply wezterm --theme ryu

Apply Ryu's dark and light schemes; WezTerm switches with host appearance.

03 - HERDR
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes setup herdr

Set up the one-time Herdr integration.

04 - HERDR
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes apply herdr --theme chun-li

Apply Chun-Li with Herdr auto-switch, then reload the server configuration.

05 - NVIM
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes setup nvim

Set up the one-time Neovim colorscheme loader.

06 - NVIM
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes apply nvim --theme ryu-light

Apply Ryu's dark and light colorschemes; Neovim follows TERM_THEME or background.

07 - CODEX
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes setup codex

Set up the one-time Codex custom theme directory.

08 - CODEX
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes apply codex --theme ryu-light

Apply Ryu Light, then restart Codex or reselect it with /theme.

09 - CLAUDE
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes setup claude

Set up the one-time Claude Code custom theme directory.

10 - CLAUDE
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes apply claude --theme ryu-light

Apply Ryu Light, then reselect it with /theme in Claude Code.

11 - STARSHIP
uvx --from git+https://github.com/douglasjarquin/sf2-themes.git sf2-themes apply starship --theme vega

Apply Vega to Starship and refresh the zsh-syntax highlight snippet.

NO GUESSWORK

  • WezTerm setup upgrades an existing assignment to the managed pointer, which auto-switches the selected character's dark and light schemes. For another selected scheme, use --adopt or paste the printed snippet.
  • Herdr apply enables theme auto-switch and writes a single [theme.custom] overlay that stable Herdr v0.8.2 understands. Unmarked [theme] sections stay unless you use --adopt. After applying, run herdr server reload-config.
  • Claude Code has no host-appearance auto-switch for custom themes, so applying a sibling just pins that one theme, like Codex.
  • install remains a deprecated alias for apply.