Help Library

COLOUR / COLOURS / ANSI

Insomnia uses Pinkfish-style colour tokens.  Type a percent sign and caret,
then the code name, then another percent sign and caret.  Reset the colour
when you are finished.

  To make red text: use the code name RED before the text, then RESET.
  To make bold yellow text: use BOLD and YELLOW before it, then RESET.
  To make a blue background: use B_BLUE before it, then NOBG or RESET.

The examples below are rendered in colour if your terminal supports them:

  %^RED%^red text%^RESET%^
  %^BOLD%^%^YELLOW%^bold yellow text%^RESET%^
  %^B_BLUE%^blue background%^NOBG%^ normal background

Most players should use one of the colour-capable terminal types, such as
"insomnia", "openclaw", "xterm-256color", "xterm-rich", "xterm-color",
"ansi", or "ansi-color".

Foreground colour codes:

  %^B_WHITE%^%^BLACK%^BLACK %^RESET%^    black in black colour
  %^DGRAY%^DGRAY %^RESET%^    dark grey in dark grey colour
  %^GREY%^GREY %^RESET%^     grey in grey colour
  %^SILVER%^SILVER %^RESET%^   silver in silver colour
  %^B_BLACK%^%^WHITE%^WHITE %^RESET%^    white in white colour

  %^RED%^RED %^RESET%^      red in red colour
  %^CRIMSON%^CRIMSON %^RESET%^  crimson in crimson colour
  %^MAROON%^MAROON %^RESET%^   maroon in maroon colour
  %^ROSE%^ROSE %^RESET%^     rose in rose colour
  %^PINK%^PINK %^RESET%^     pink in pink colour

  %^ORANGE%^ORANGE %^RESET%^   orange in orange colour
  %^AMBER%^AMBER %^RESET%^    amber in amber colour
  %^GOLD%^GOLD %^RESET%^     gold in gold colour
  %^YELLOW%^YELLOW %^RESET%^   yellow in yellow colour
  %^BROWN%^BROWN %^RESET%^    brown in brown colour
  %^TAN%^TAN %^RESET%^      tan in tan colour

  %^GREEN%^GREEN %^RESET%^    green in green colour
  %^LIME%^LIME %^RESET%^     lime in lime colour
  %^OLIVE%^OLIVE %^RESET%^    olive in olive colour
  %^SEA%^SEA %^RESET%^      sea green in sea green colour
  %^TEAL%^TEAL %^RESET%^     teal in teal colour

  %^CYAN%^CYAN %^RESET%^     cyan in cyan colour
  %^SKY%^SKY %^RESET%^      sky blue in sky blue colour
  %^BLUE%^BLUE %^RESET%^     blue in blue colour
  %^INDIGO%^INDIGO %^RESET%^   indigo in indigo colour
  %^VIOLET%^VIOLET %^RESET%^   violet in violet colour
  %^PURPLE%^PURPLE %^RESET%^   purple in purple colour
  %^MAGENTA%^MAGENTA %^RESET%^  magenta in magenta colour

Background colour codes:

  %^B_BLACK%^%^WHITE%^B_BLACK %^RESET%^    black background
  %^B_DGRAY%^%^WHITE%^B_DGRAY %^RESET%^    dark grey background
  %^B_GREY%^%^BLACK%^B_GREY %^RESET%^     grey background
  %^B_SILVER%^%^BLACK%^B_SILVER %^RESET%^   silver background
  %^B_WHITE%^%^BLACK%^B_WHITE %^RESET%^    white background

  %^B_RED%^%^WHITE%^B_RED %^RESET%^      red background
  %^B_CRIMSON%^%^WHITE%^B_CRIMSON %^RESET%^  crimson background
  %^B_MAROON%^%^WHITE%^B_MAROON %^RESET%^   maroon background
  %^B_ROSE%^%^BLACK%^B_ROSE %^RESET%^     rose background
  %^B_PINK%^%^BLACK%^B_PINK %^RESET%^     pink background

  %^B_ORANGE%^%^BLACK%^B_ORANGE %^RESET%^   orange background
  %^B_AMBER%^%^BLACK%^B_AMBER %^RESET%^    amber background
  %^B_GOLD%^%^BLACK%^B_GOLD %^RESET%^     gold background
  %^B_YELLOW%^%^BLACK%^B_YELLOW %^RESET%^   yellow background
  %^B_BROWN%^%^WHITE%^B_BROWN %^RESET%^    brown background
  %^B_TAN%^%^BLACK%^B_TAN %^RESET%^      tan background

  %^B_GREEN%^%^WHITE%^B_GREEN %^RESET%^    green background
  %^B_LIME%^%^BLACK%^B_LIME %^RESET%^     lime background
  %^B_OLIVE%^%^WHITE%^B_OLIVE %^RESET%^    olive background
  %^B_SEA%^%^WHITE%^B_SEA %^RESET%^      sea green background
  %^B_TEAL%^%^WHITE%^B_TEAL %^RESET%^     teal background

  %^B_CYAN%^%^BLACK%^B_CYAN %^RESET%^     cyan background
  %^B_SKY%^%^BLACK%^B_SKY %^RESET%^      sky blue background
  %^B_BLUE%^%^WHITE%^B_BLUE %^RESET%^     blue background
  %^B_INDIGO%^%^WHITE%^B_INDIGO %^RESET%^   indigo background
  %^B_VIOLET%^%^WHITE%^B_VIOLET %^RESET%^   violet background
  %^B_PURPLE%^%^WHITE%^B_PURPLE %^RESET%^   purple background
  %^B_MAGENTA%^%^BLACK%^B_MAGENTA %^RESET%^  magenta background

Text and terminal control codes:

  BOLD       bold or bright text
  UNDERLINE  underlined text
  BLINK      blinking text, if supported
  FLASH      alias for BLINK
  REVERSE    reverse video
  RESET      reset all colour and attributes
  NOBG       clear background colour only

  INITTERM   terminal setup sequence
  ENDTERM    terminal shutdown sequence
  CLEARLINE  clear the current line
  STATUS     status-line control, if supported
  WINDOW     window/status control, if supported

Notes:

  Codes may be combined.  For example:

    %^BOLD%^%^GREEN%^bright green%^RESET%^
    %^B_BLACK%^%^GOLD%^gold on black%^RESET%^

  The extended colour names look best on the Insomnia/OpenClaw client or a
  256-colour terminal.  On simpler ANSI terminals, close colours may be used
  instead.  Terminals are normally reset at the end of a line, but RESET is
  still the safest way to end coloured text.

See also: help terminal, help setenv