{
  "name": "theme",
  "section": 1,
  "title": "switch Bare OS color theme",
  "synopsis": ["theme [list|current|set <name>|apply]"],
  "description": "Lists bundled theme presets, shows the active BARE_OS_THEME, writes theme <name> to ~/.barerc and reapplies colors (when the booter provides bareOsApplyTheme), or reapplies the current theme without editing the file.",
  "options": [],
  "keywords": ["theme", "colors", "LS_COLORS", "prompt"],
  "bareOsNotes": "Requires ctx.bareOsApplyTheme for set/apply to refresh env; list/current work with static preset names.",
  "examples": [
    { "caption": "list presets", "code": "theme list" },
    { "caption": "switch to Nord palette", "code": "theme set nord" },
    { "caption": "re-apply after manual env edits", "code": "theme apply" }
  ]
}