-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ PL
🌍 English · Polski · Français · Deutsch · 中文
Często zadawane pytania o ECLI.
ECLI (Editor CLI) to terminalowe IDE zbudowane w Pythonie. Łączy curses-based edytor z AI, Git, LSP, podświetlaniem składni Tree-sitter i systemem pluginów. Zaprojektowane dla deweloperów którzy wolą pracować w całości w terminalu.
Pozycjonowanie ECLI:
- Vim/Neovim — bardzo potężne ale stroma krzywa nauki i ciężar konfiguracji.
- Emacs — Lisp-based, ekstremalna elastyczność, ale duży overhead.
- nano — minimalistyczny, brak funkcji IDE.
- Helix — nowoczesny, modal, ale bez panelu AI i Rust-based extensibility.
- ECLI — ergonomia IDE (znane Ctrl+S/Ctrl+O), AI wbudowane, Python plugins, jeden TOML config. Cel: "VS Code w terminalu" zamiast "Vim z bateriami".
Jeśli Vim/Helix pasują do Twojego workflow, zostań przy nich. ECLI istnieje dla ludzi którzy chcą konwencji IDE w TUI.
Tak — licencja Apache 2.0. Darmowe do dowolnego użytku łącznie z komercyjnym.
Tak. ECLI to aplikacja terminalowa. Działa wszędzie gdzie ssh + działający terminal. Performance jest świetne nawet na wolnych łączach bo wysyła tylko tekst delta, nie framebuffery.
Nie. ECLI:
- Zapisuje atomowo (pisze do pliku temp, potem rename).
- Pyta przed wyjściem z niezapisanymi zmianami (
Ctrl+Q). - Trzyma integrację Git read-only domyślnie — destrukcyjne operacje (force push, reset hard) wymagają jawnego potwierdzenia.
Jeśli coś się zepsuje: otwórz issue z zawartością editor.log.
-
Pakiet natywny jeśli chcesz samowystarczalny binary bez Pythona w systemie:
.deb/.rpm/.pkg/.dmg/.exe. -
PyPI jeśli masz już Python 3.11+:
pip install ecli-editor. - Ze źródeł jeśli chcesz kontrybuować lub używać niewydanych funkcji.
- Pakiety natywne: nie. Zawierają Pythona przez PyInstaller.
- PyPI: tak, 3.11+.
PyInstaller pakuje runtime Pythona + wszystkie zależności do jednego pliku. To cena za instalację bez zależności. Wheel z PyPI jest dużo mniejszy (~1 MB) bo polega na Twojej instalacji Pythona.
Tak. DMG dla macOS jest Universal2 (arm64 + x86_64). Bez Rosetta na M1/M2/M3/M4.
Jeszcze nie. Release Windows jest tylko x86_64. Wsparcie ARM Windows jest na roadmap.
Nie. Nowoczesny Python i większość zależności wymagają 64-bit.
Patrz Konfiguracja AI. Krótko: edytuj ~/.config/ecli/config.toml i dodaj API key pod [ai.<provider>].
Tak. Ustaw default_provider = "none" w configu, lub po prostu nie otwieraj panelu.
Gramatyki Tree-sitter dla 70+ języków: Python, JavaScript, TypeScript, Go, Rust, C, C++, Java, Ruby, PHP, HTML, CSS, JSON, YAML, TOML, Markdown, SQL, Bash, PowerShell i więcej.
Tak, ECLI implementuje klienta Language Server Protocol. Zainstaluj language servers per język:
# Python
pip install python-lsp-server
# Rust
rustup component add rust-analyzer
# Go
go install golang.org/x/tools/gopls@latest
# TypeScript / JavaScript
npm install -g typescript-language-serverSkonfiguruj w ~/.config/ecli/config.toml:
[lsp]
enabled = true
[lsp.python]
command = "pylsp"
[lsp.rust]
command = "rust-analyzer"Tak. ECLI wywołuje binary git. Zainstaluj przez swoją dystrybucję.
Tak. ECLI działa w tmux bez specjalnej konfiguracji. Upewnij się że tmux jest ustawiony na 256-color lub truecolor:
# ~/.tmux.conf
set -g default-terminal "tmux-256color"
set -as terminal-features ",xterm-256color:RGB"
Tak, ECLI wspiera zaznaczanie myszą, scrollowanie i zmianę rozmiaru paneli w terminalach które wspierają eventy myszy (większość nowoczesnych).
Nie w 0.1.x. Planowane na v0.2.
Komfortowo testowane do ~50 MB. Powyżej tego parsing Tree-sitter i LSP mogą zwalniać. Dla multi-GB log files użyj less lub dedykowanego narzędzia.
Zależy od providera:
- Anthropic / OpenAI — round-trip sieci (typowo 200-2000 ms).
- Ollama — rozmiar lokalnego modelu; modele 7B odpowiadają w 1-5 sekund.
Jeśli odpowiedzi są znacznie wolniejsze, patrz Rozwiązywanie problemów › AI.
| Platforma | Ścieżka |
|---|---|
| Linux / FreeBSD | ~/.config/ecli/config.toml |
| macOS | ~/Library/Application Support/ecli/config.toml |
| Windows | %APPDATA%\ecli\config.toml |
Usuń plik configu. ECLI wygeneruje go przy następnym uruchomieniu.
Tak. Wrzuć .ecli.toml w root projektu. Nadpisuje user config tylko dla tego projektu. Patrz Konfiguracja › Per projekt.
Tak, w Pythonie. Patrz Motywy i personalizacja › Pluginy.
- "ecli: command not found" → Rozwiązywanie problemów
- macOS Gatekeeper blokuje pierwsze uruchomienie → Instalacja › macOS
- Windows SmartScreen ostrzeżenie → Instalacja › Windows
- Pokraczne kolory → Motywy › Uwagi o palecie
- AI "API key not configured" → Konfiguracja AI
Pełna lista: Rozwiązywanie problemów.
Kolejno:
- Przeszukaj GitHub Discussions
- Przeszukaj GitHub Issues (łącznie z zamkniętymi)
- Otwórz nowy issue z
editor.logi swoim configiem (zredaguj klucze API)
Patrz Contributing. PR mile widziane dla bug fixów, definicji języków, motywów, pluginów, dokumentacji.
Tak: Roadmap.
"Editor CLI" — wymawiane "echo lee". Logo to stylizowane E przywołujące zarówno edytor jak i prompty CLI.
Maintainer: Siergej Sobolewski. Kontrybucje mile widziane.
Semantic versioning: MAJOR.MINOR.PATCH. Obecnie 0.x — spodziewaj się okazjonalnych breaking changes w configu między minor versions aż do 1.0.
ecli.io · PyPI · GitHub · Apache-2.0
ECLI — The Next-Generation Terminal IDE · © 2026 Siergej Sobolewski