Themes

A theme colours the parts koshi draws itself: pane borders, the tab bar, key hints, and stack headers. Programs running inside a pane keep their own colours.

The file name is the theme name. themes/midnight.kdl is the theme midnight; the file carries no name of its own. It lives in a themes/ subdirectory of the config directory.

Select it in koshi.kdl:

version 1
theme "midnight"        // reads themes/midnight.kdl

The built-in default colours apply when theme is omitted, when it is "default", or when the selected file is missing or invalid. koshi logs theme load errors, and a single bad colour keeps its default while the rest of the file still applies.

colors

The file is the theme — no wrapping block, just a required version and an optional colors block. Every colour is a #RRGGBB hex string; the leading # is optional.

The tab and key-hint bars fade from ramp-start to ramp-end. bar-bg fills both rows. on-ramp and on-accent colour text drawn over filled blocks.

Keep the ramp readable against bar-bg, and on-ramp readable against the ramp.

Every colour at its default

// themes/midnight.kdl — every colour, at its default value.
version 1

colors {
    ramp-start "#d0a5ff"
    ramp-end "#7dbcff"
    on-ramp "#12091f"
    on-ramp-dim "#f0ecfa"
    accent "#f5c2ff"
    on-accent "#1e1033"
    bar-bg "#000000"
    border-focused "#00afd7"
    border-unfocused "#585858"
    border-hover "#af5fff"
    stack-header-fg "#f4f1fa"
    stack-header-bg "#300f4a"
    letterbox "#585858"
}

Built-in default and twenty-five ready-made themes

The first preview is koshi's built-in default. Copy any of the other twenty-five out of themes-example/ in the koshi repository into your themes/ directory. Each preview applies visible colours exactly where koshi's renderer does: bar fill, ramp text and hint ribbons, pane borders, and letterbox. The ~/Projects/koshi-docs title sits in its top border; 3/388 is a scrolled pane's up/retained marker in its bottom border. The compact grid stays unstacked, so the copied file keeps its stack-header colours without inventing a stack on screen. Terminal content keeps its own fixed colours.