Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
Plugin themes
Plugins contribute three kinds of theme through orca-plugin.json contributes:
themes (app colors), terminalThemes (an ANSI palette) and, separately, icon themes.
Each entry is { "id", "label", "path" } pointing at a JSON file of at most 16 KiB.
App themes
{
"schemaVersion": 1,
"base": "dark",
"tokens": { "--background": "#1b1430", "--foreground": "#e8e0ff" }
}
schemaVersionis optional for app themes and must be1when present.base(lightordark) picks the slot the theme fills: users choose a Light theme and a Dark theme separately, and Orca paints the one for its current mode (following the OS under System). Contribute one theme of each base to ship a pair; installing it fills both slots.--backgroundand--foregroundare required. Every other public token is optional; an omitted token is derived from the ones you set (cards from--background, sidebars lifted a step off--backgroundso the left sidebar keeps a visible edge, text from--foreground, sidebar accents from--accent, rings from--primary, and so on), so a two-token theme still colors the whole app.- Theme tokens lists every public token and what it falls back to when omitted. Other variables cannot be set.
- Values must be colors: hex, a color function (
rgb,hsl,oklch, …) or a color name.transparent,currentColor, CSS-wide keywords, lengths,calc(),var()andurl()are refused. - Each text/surface pair (for example
--background/--foreground,--primary/--primary-foreground) must be opaque with at least 4.5:1 contrast; a pair that fails is dropped and keeps Orca's built-in colors. - Trust and approval dialogs always use Orca's own colors, whatever theme is active.
pnpm validate:pluginrefuses unknown keys, tokens and slots in every theme file. Orca itself skips them, so a theme that sets a token added in a newer release still loads on older ones.
Code colors
An app theme also colors the code editor: its background, text, line numbers, cursor and
selection follow the theme's tokens. To color code itself, add tokenColors (Orca 1.4.245 and
later) in the same shape as a VS Code theme's, so most VS Code theme lists paste in unchanged (validate:plugin flags entries without a scope and any setting other than these two):
{
"base": "dark",
"tokens": { "--background": "#1b1430", "--foreground": "#e8e0ff" },
"tokenColors": [
{ "scope": "comment", "settings": { "foreground": "#8f84ad", "fontStyle": "italic" } },
{ "scope": ["keyword", "storage"], "settings": { "foreground": "#ff7ad9" } },
{ "scope": "string", "settings": { "foreground": "#a8e6a1" } },
{ "scope": "constant.numeric", "settings": { "foreground": "#ffb86c" } },
{ "scope": "entity.name.function", "settings": { "foreground": "#82cfff" } },
{ "scope": "markup.heading", "settings": { "foreground": "#ff7ad9", "fontStyle": "bold" } }
]
}
scopeis a TextMate scope or a list of them (a comma-separated string works too). Scopes follow the TextMate naming convention:comment,string,constant.numeric,keyword.control,keyword.operator,entity.name.function,entity.name.type,variable,punctuation,markup.heading,markup.underline.link,invalid, and so on. A scope also colors everything beneath it (keywordcoverskeyword.control.flow); the longest match wins, then the later rule.settings.foregroundis a hex color;settings.fontStyleisitalic,bold,underline,strikethrough, a space-separated combination, or""for none.nameis allowed and ignored.- Orca applies them to its built-in languages and to plugin syntaxes alike. Selectors with
spaces (descendant scopes) and
semanticTokenColorsare not read. - A color under 3:1 contrast with the editor background is dropped, and anything a theme leaves out keeps the built-in light or dark code colors.
Terminal themes
{
"schemaVersion": 1,
"mode": "dark",
"terminal": { "background": "#1b1430", "foreground": "#e8e0ff", "red": "#ff6b8b" }
}
Colors are hex. A palette needs background, foreground and at least one ANSI color. When a
user selects it, Orca saves a copy of the palette in settings so hosts, headless servers and
relays answer terminal color queries without the plugin loaded.