Temalar

pi temalar oluşturabilir. Kurulumunuz için bir tane oluşturmasını isteyin.

Temalar, TUI için renkleri tanımlayan JSON dosyalardır.

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

Pi temaları şuradan yükler:

• Dahili: dark, light
• Küresel: ~/.pi/agent/themes/*.json
• Proje: .pi/themes/*.json (yalnızca projeye güvenildikten sonra)
• Paketler: themes/ dizinler veya package.json içindeki pi.themes girişler
• Ayarlar: themes dosya veya dizin içeren dizi
• CLI: --theme <path> (tekrarlanabilir)

--no-themes ile keşfi devre dışı bırakın.

/settings veya settings.json aracılığıyla bir tema seçin:

{
  "theme": "my-theme"
}

İlk çalıştırmada pi, terminal arka planınızı algılar ve varsayılan olarak dark veya light olur.

1. Bir tema dosyası oluşturun:

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

2. Temayı gerekli tüm renklerle tanımlayın (bkz. 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 ile temayı seçin.

Çalışırken yeniden yükleme: Şu ​​anda etkin olan özel tema dosyasını düzenlediğinizde, pi anında görsel geri bildirim için dosyayı otomatik olarak yeniden yükler.

{
  "$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 gereklidir, benzersiz olmalı ve / içermemelidir.
• vars isteğe bağlıdır. Yeniden kullanılabilir renkleri burada tanımlayın ve ardından colors'de bunlara referans verin.
• colors gerekli 51 jetonun tamamını tanımlamalıdır. thinkingMax isteğe bağlıdır ve thinkingXhigh'ye geri döner; scrollbarThumb isteğe bağlıdır ve selectedBg'ye geri döner.

$schema alanı, düzenleyicinin otomatik tamamlamasını ve doğrulamasını sağlar.

Her tema gerekli 51 renk jetonunun tümünü tanımlamalıdır. thinkingMax ve scrollbarThumb mevcut temalarla uyumluluk açısından isteğe bağlıdır; atlandığında sırasıyla thinkingXhigh ve selectedBg'yi kullanırlar.

Düşünme düzeyini gösteren düzenleyici kenarlık renkleri (inceden göze çarpana doğru görsel hiyerarşi):

export bölümü, /export HTML çıktısının renklerini kontrol eder. Atlanırsa renkler userMessageBg'den türetilir.

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

Dört format desteklenir:

• 0-15: Temel ANSI renkleri (terminale bağlı)
• 16-231: 6×6×6 RGB küp (16 + 36×R + 6×G + B burada R,G,B 0-5'tir)
• 232-255: Gri tonlamalı rampa

Pi 24 bit RGB renkleri kullanır. Çoğu modern terminal bunu destekler (iTerm2, Kitty, WezTerm, Windows Terminal, VS Code). Yalnızca 256 renk desteğine sahip eski terminaller için pi, en yakın yaklaşıma geri döner.

Truecolor desteğini kontrol edin:

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

Koyu terminaller: Daha yüksek kontrastlı, parlak, doygun renkler kullanın.

Açık terminaller: Daha düşük kontrastlı, daha koyu, yumuşak renkler kullanın.

Renk uyumu: Temel bir paletle başlayın (Nord, Gruvbox, Tokyo Night), onu vars ile tanımlayın ve tutarlı bir şekilde referans verin.

Test: Farklı mesaj türleri, araç durumları, işaretleme içeriği ve uzun sarılmış metinlerle temanızı kontrol edin.

VS Kodu: Doğru renkler için terminal.integrated.minimumContrastRatio'ı 1 olarak ayarlayın.

Yerleşik temalara bakın:

• dark.json
• light.json