Configuration PL

Konfiguracja

🌍 English · Polski · Français · Deutsch · 中文

ECLI konfiguruje się jednym plikiem TOML. Domyślne wartości są sensowne — większość użytkowników edytuje tylko sekcję providera AI i motyw.

Gdzie znajduje się config

Platforma	Ścieżka
Linux / FreeBSD	~/.config/ecli/config.toml
macOS	~/Library/Application Support/ecli/config.toml
Windows	%APPDATA%\ecli\config.toml

Można nadpisać przez --config /sciezka/do/config.toml w linii poleceń lub przez zmienną środowiskową ECLI_CONFIG:

ECLI_CONFIG=/tmp/test-config.toml ecli

Pierwszeństwo

Gdy to samo ustawienie jest zdefiniowane w wielu miejscach, ECLI stosuje (najwyższy priorytet):

1. Flagi linii poleceń (--theme dark)
2. Zmienne środowiskowe (ECLI_THEME=dark)
3. User config (~/.config/ecli/config.toml)
4. Wbudowane wartości domyślne

Generowanie przy pierwszym uruchomieniu

Przy pierwszym uruchomieniu ECLI tworzy domyślny config z komentarzami inline opisującymi każdy klucz. Można wygenerować go ponownie:

ecli --print-default-config > ~/.config/ecli/config.toml

Przegląd schematu

Config dzieli się na nazwane sekcje:

[editor]      # tab size, line endings, auto-save
[ui]          # motyw, szerokości paneli, status bar
[keybindings] # własne mapowania klawiszy
[ai]          # wybór providera AI
[ai.openai]   # ustawienia per provider
[ai.anthropic]
[ai.ollama]
[ai.huggingface]
[git]         # zachowanie integracji git
[lsp]         # preferencje language server
[linters]     # wybór lintera per język
[panels]      # które panele są włączone

Pełna referencja z każdym kluczem i typem: docs/config/config-schema.md.

Najczęstsze zmiany

Zmiana motywu

[ui]
theme = "dark"   # lub "light", "solarized-dark", "monokai", "nord"

Motywy są wbudowane. Aby stworzyć własny motyw, patrz Motywy i personalizacja.

Ustaw providera AI

[ai]
default_provider = "anthropic"   # jeden z: openai, anthropic, ollama, huggingface, none

[ai.anthropic]
api_key = "sk-ant-..."
model = "claude-sonnet-4-5"
max_tokens = 4096

Klucze mogą też pochodzić ze zmiennych środowiskowych — patrz Konfiguracja AI.

Szerokość tabulatora

[editor]
tab_width = 4
use_spaces = true   # zamień tab na spacje

Znaki końca linii

[editor]
line_ending = "lf"   # lub "crlf", "auto" (wykryj z pliku)

Wyłącz autosave

[editor]
autosave = false

Włącz Ruff dla Pythona

[linters]
python = "ruff"   # domyślnie; alternatywy: pylint, flake8, none

Minimalny działający config

Jeśli chcesz zacząć od zera:

[editor]
tab_width = 4
use_spaces = true

[ui]
theme = "dark"

[ai]
default_provider = "none"

[git]
auto_fetch = false

[lsp]
enabled = true

Wrzuć to do swojej ścieżki config — ECLI zadziała.

Migracja

Gdy ECLI podnosi schemat configu (rzadko), migruje automatycznie i robi backup starego do config.toml.bak. Semantyka migracji: config-migration-policy.

Config per projekt (opcjonalnie)

ECLI szuka .ecli.toml w bieżącym katalogu roboczym. Ustawienia tam nadpisują user config tylko dla tego projektu.

Przykład .ecli.toml:

[editor]
tab_width = 2          # ten projekt używa wcięcia 2 spacje

[linters]
python = "pylint"      # ten projekt standaryzuje pylint

Walidacja configu

ecli --check-config
# Zwraca exit 0 przy sukcesie, wypisuje błędy w przeciwnym razie.

To jest również uruchamiane automatycznie przy każdym starcie — błędny config fallback'uje na defaults z ostrzeżeniem.

Patrz też

• Konfiguracja AI — pełna konfiguracja per provider
• Motywy i personalizacja — wygląd
• Skróty klawiszowe — personalizacja skrótów
• docs/config/config-schema.md — każda opcja udokumentowana