Темы

pi может создавать темы. Попросите его создать его для вашей установки.

Темы — это файлы JSON, определяющие цвета для TUI.

• Locations
• Selecting a Theme
• Creating a Custom Theme
• Theme Format
• Color Tokens
• Color Values
• Tips

Pi загружает темы из:

• Встроенные: dark, light
• Глобально: ~/.pi/agent/themes/*.json
• Проект: .pi/themes/*.json (только после того, как проекту доверяют)
• Пакеты: themes/ каталогов или pi.themes записей в package.json.
• Настройки: themes массив с файлами или каталогами.
• CLI: --theme <path> (повторяемый)

Отключите обнаружение с помощью --no-themes.

Выберите тему с помощью /settings или settings.json:

{
  "theme": "my-theme"
}

При первом запуске pi определяет фон вашего терминала и по умолчанию устанавливает значение dark или light.

1. Создайте файл темы:

mkdir -p ~/.pi/agent/themes
vim ~/.pi/agent/themes/my-theme.json

2. Определите тему со всеми необходимыми цветами (см. Color Tokens):

{
  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
  "name": "my-theme",
  "vars": {
    "primary": "#00aaff",
    "secondary": 242
  },
  "colors": {
    "accent": "primary",
    "border": "primary",
    "borderAccent": "#00ffff",
    "borderMuted": "secondary",
    "success": "#00ff00",
    "error": "#ff0000",
    "warning": "#ffff00",
    "muted": "secondary",
    "dim": 240,
    "text": "",
    "thinkingText": "secondary",
    "selectedBg": "#2d2d30",
    "scrollbarThumb": "#555566",
    "userMessageBg": "#2d2d30",
    "userMessageText": "",
    "customMessageBg": "#2d2d30",
    "customMessageText": "",
    "customMessageLabel": "primary",
    "toolPendingBg": "#1e1e2e",
    "toolSuccessBg": "#1e2e1e",
    "toolErrorBg": "#2e1e1e",
    "toolTitle": "primary",
    "toolOutput": "",
    "mdHeading": "#ffaa00",
    "mdLink": "primary",
    "mdLinkUrl": "secondary",
    "mdCode": "#00ffff",
    "mdCodeBlock": "",
    "mdCodeBlockBorder": "secondary",
    "mdQuote": "secondary",
    "mdQuoteBorder": "secondary",
    "mdHr": "secondary",
    "mdListBullet": "#00ffff",
    "toolDiffAdded": "#00ff00",
    "toolDiffRemoved": "#ff0000",
    "toolDiffContext": "secondary",
    "syntaxComment": "secondary",
    "syntaxKeyword": "primary",
    "syntaxFunction": "#00aaff",
    "syntaxVariable": "#ffaa00",
    "syntaxString": "#00ff00",
    "syntaxNumber": "#ff00ff",
    "syntaxType": "#00aaff",
    "syntaxOperator": "primary",
    "syntaxPunctuation": "secondary",
    "thinkingOff": "secondary",
    "thinkingMinimal": "primary",
    "thinkingLow": "#00aaff",
    "thinkingMedium": "#00ffff",
    "thinkingHigh": "#ff00ff",
    "thinkingXhigh": "#ff0000",
    "thinkingMax": "#ff0088",
    "bashMode": "#ffaa00"
  }
}

3. Выберите тему с помощью /settings.

Горячая перезагрузка. Когда вы редактируете активный в данный момент файл пользовательской темы, pi автоматически перезагружает его для немедленной визуальной обратной связи.

{
  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
  "name": "my-theme",
  "vars": {
    "blue": "#0066cc",
    "gray": 242
  },
  "colors": {
    "accent": "blue",
    "muted": "gray",
    "text": "",
    ...
  }
}

• name обязателен, должен быть уникальным и не должен содержать /.
• vars не является обязательным. Определите здесь повторно используемые цвета, а затем укажите их в colors.
• colors должен определять все 51 требуемый токен. thinkingMax не является обязательным и возвращается к thinkingXhigh; scrollbarThumb не является обязательным и возвращается к selectedBg.

Поле $schema включает автозаполнение и проверку редактора.

Каждая тема должна определять все 51 требуемый жетон цвета. thinkingMax и scrollbarThumb являются необязательными для совместимости с существующими темами; если они опущены, они используют thinkingXhigh и selectedBg соответственно.

Цвета границ редактора обозначают уровень мышления (визуальная иерархия от незаметного до заметного):

Раздел export управляет цветами для вывода HTML /export. Если этот параметр опущен, цвета получаются из userMessageBg.

{
  "export": {
    "pageBg": "#18181e",
    "cardBg": "#1e1e24",
    "infoBg": "#3c3728"
  }
}

Поддерживаются четыре формата:

• 0-15: базовые цвета ANSI (зависят от терминала).
• 16-231: RGB-куб 6×6×6 (16 + 36×R + 6×G + B, где R,G,B равны 0–5)
• 232-255: шкала оттенков серого.

Pi использует 24-битные цвета RGB. Большинство современных терминалов поддерживают это (iTerm2, Kitty, WezTerm, Windows Terminal, VS Code). Для старых терминалов, поддерживающих только 256 цветов, число pi возвращается к ближайшему приближению.

Проверьте поддержку truecolor:

echo $COLORTERM  # Should output "truecolor" or "24bit"

Тёмные терминалы. Используйте яркие, насыщенные цвета с более высокой контрастностью.

Светлые терминалы. Используйте более темные, приглушенные цвета с меньшей контрастностью.

Цветовая гармония. Начните с базовой палитры (Nord, Gruvbox, Tokyo Night), определите ее в vars и последовательно используйте ссылки.

Тестирование. Проверьте свою тему с различными типами сообщений, состояниями инструментов, содержимым уценки и длинным текстом.

Код VS: Установите от terminal.integrated.minimumContrastRatio до 1 для получения точных цветов.

Посмотрите встроенные темы:

• dark.json
• light.json