Getting Started PL

Pierwsze kroki

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

Witaj w ECLI. Ta strona przeprowadzi Cię przez pierwsze 5 minut — instalacja, uruchomienie, edycja, zapis.

1. Instalacja

Wybierz najszybszą ścieżkę dla swojej platformy:

# Debian / Ubuntu
sudo apt install ./ecli_0.1.3_linux_x86_64.deb

# Fedora / RHEL / Rocky
sudo dnf install ./ecli_0.1.3_linux_x86_64.rpm

# FreeBSD
sudo pkg add ./ecli_0.1.3_freebsd_x86_64.pkg

# macOS (drag-and-drop, potem zatwierdź w System Settings)
open ecli_0.1.3_macos_universal2.dmg

# Windows (PowerShell, jako użytkownik)
.\ecli_0.1.3_win_x86_64_setup.exe

# Wieloplatformowo przez PyPI (Python 3.11+)
pip install ecli-editor

Szczegóły instalacji (Gatekeeper na macOS, SmartScreen na Windows, zależności ncurses na Linuksie) — patrz Instalacja.

2. Weryfikacja

ecli --version
# Oczekiwane: ecli 0.1.3 (lub nowszy)

ecli --help

Jeśli ecli nie jest w PATH, patrz Rozwiązywanie problemów › Polecenie nieznalezione.

3. Pierwsze uruchomienie

Otwórz dowolny plik tekstowy:

ecli README.md

Lub uruchom ECLI bez pliku (możesz otwierać pliki z wnętrza):

ecli

Zobaczysz:

• Górny pasek — nazwa pliku, wskaźnik modyfikacji, kodowanie, pozycja kursora
• Obszar edycji — Twój plik
• Dolny pasek statusu — branch Git, status LSP, licznik linii
• Pasek podpowiedzi — aktualny kontekst skrótów

4. Najważniejsze skróty

Akcja	Klawisz
Zapisz	Ctrl+S
Otwórz plik	Ctrl+O
Nowy plik	Ctrl+N
Wyjście (z pytaniem jeśli niezapisane)	Ctrl+Q
Wyszukiwanie	Ctrl+F
Idź do linii	Ctrl+G (gdy panel Git zamknięty)
Panel AI	Ctrl+A
Panel Git	Ctrl+G (gdy żaden inny panel otwarty)
Pomoc	F1

Pełna lista: Skróty klawiszowe.

5. Wypróbuj panel AI (opcjonalnie)

Jeśli skonfigurowałeś providera AI (patrz Konfiguracja AI):

1. Naciśnij Ctrl+A — otwiera się panel AI.
2. Wpisz pytanie lub wklej kod z prośbą.
3. Wyślij — pojawi się odpowiedź AI.
4. Naciśnij Esc aby zamknąć panel.

Brak providera? ECLI działa bez problemu bez AI. Panel pokaże komunikat "brak providera" dopóki któryś nie zostanie skonfigurowany.

6. Wypróbuj integrację z Git

Wewnątrz repo Git:

1. Naciśnij Ctrl+G — panel Git otwiera się ze statusem.
2. Zobacz pliki zmodyfikowane / staged / untracked.
3. Stage, commit, push, pull — wszystko z panelu.
4. Esc zamyka panel.

7. Personalizacja

Domyślna konfiguracja znajduje się w:

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

Przy pierwszym uruchomieniu ECLI tworzy domyślny config z opcjami opisanymi inline. Otwórz: ecli ~/.config/ecli/config.toml.

Typowe pierwsze zmiany:

• Zmiana motywu ([ui] theme = "dark" → "light")
• Ustawienie kluczy AI
• Dostosowanie szerokości tabulatora

Pełna referencja: Konfiguracja.

Co dalej

• Skróty klawiszowe — pełna lista
• Konfiguracja AI — OpenAI / Anthropic / Ollama / HuggingFace
• Motywy i personalizacja — wygląd
• FAQ — częste pytania
• Rozwiązywanie problemów — gdy coś nie działa