From 539e7ae330991cfb518e40b2a5aab3ff18ef4371 Mon Sep 17 00:00:00 2001 From: skylight74 Date: Sun, 18 Jan 2026 09:37:37 +0300 Subject: [PATCH] docs: add theme hot-reloading section with SIGUSR2 signal --- packages/web/src/content/docs/themes.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/packages/web/src/content/docs/themes.mdx b/packages/web/src/content/docs/themes.mdx index d37ce3135569..58dc96b6a0a2 100644 --- a/packages/web/src/content/docs/themes.mdx +++ b/packages/web/src/content/docs/themes.mdx @@ -59,6 +59,23 @@ The system theme is for users who: --- +## Theme hot-reloading + +OpenCode supports hot-reloading themes without restarting the application. This is useful for testing custom theme changes in real-time or integrating with dynamic theming tools. + +To trigger a theme reload, send the `SIGUSR2` signal to the OpenCode process: + +```bash no-frame +pkill -USR2 -x opencode +``` + +This will: +1. Clear the cached terminal color palette +2. Reload all custom themes from disk +3. Re-apply the current theme with updated colors + +--- + ## Using a theme You can select a theme by bringing up the theme select with the `/theme` command. Or you can specify it in your [config](/docs/config).