Ecli Logo

The Next-Gen Terminal Code Editor

A fast, lightweight, and extensible code editor built for serious terminal workflows. Powered by Python and designed for developers who value speed, privacy, and control.

Lightning Fast
Cross-Platform
Open Source
Apache-2.0

Latest stable release v0.1.3 • Apache-2.0 License

Built for Real Terminal Productivity

Ecli is a fast, lightweight, and honest terminal code editor crafted for developers who spend most of their time in the terminal.

Why developers choose Ecli

Lightning Fast
Built with Python and curses, Ecli starts quickly and stays responsive with large files. No Electron runtime, no heavy desktop shell, just clean terminal rendering.
Truly Cross-Platform
One editor, consistent terminal workflow. Native installers and portable artifacts for Windows 10+, macOS 12+, Linux (.deb, .rpm, AppImage), and FreeBSD.
Private AI Assistant
Optional after installation. Add provider API keys in ~/.config/ecli/.env and choose the provider in config.toml, then ask for explanations, snippets, and debugging help.
Seamless Git Integration
See branch state, working-tree status, file changes, and common Git actions directly in the editor. Context stays close to the code you are editing.
Deeply Customizable
TOML-based configuration, flexible keybindings, themes, AI provider settings, and a plugin-oriented architecture let you tune the editor around your workflow.
Private by Design
No telemetry and no data collection. Local editing stays local; AI requests only happen when you explicitly use a configured provider.
Smart Language Support
Pygments provides broad syntax highlighting, while Ruff LSP gives Python projects fast diagnostics without turning the editor into a heavyweight IDE.
Built for Terminal Natives
Designed for SSH sessions, remote servers, and keyboard-first terminal work. Rendering accounts for wide Unicode characters and constrained terminal screens.
Thoughtful Editing Features
Undo and redo, efficient search and replace, language-aware line/block commenting, Python docstring handling, and multi-language awareness for serious coding sessions.

Built With

Python 3.11+cursesPyInstallerAsyncioPygmentsRuff LSP

See Ecli in Action

Experience the clean, modern interface designed for productivity and focus.

Editor

Code Editor Interface

Responsive terminal editing with Pygments syntax highlighting

Navigation

File Explorer

Project navigation designed for keyboard-first terminal workflows

Assistant

AI Chat Panel

Ask questions, request explanations, and generate snippets with a configured provider

Git

Git Workflow

Repository status, branch information, and quick Git commands in the editor

More screenshots and demos coming soon. Follow our GitHub repository for updates.

Keyboard Shortcuts

Master Ecli with these essential keyboard shortcuts. Press F1 anytime inside the editor to open this help screen.

Basic Editing
ShortcutAction
BackspaceDelete character left / delete selection
TabSmart indent / indent block
Shift+TabSmart unindent
Ctrl+\Toggle comment (line/block)
Ctrl+CCopy
Ctrl+XCut
Ctrl+VPaste
Ctrl+ASelect all
Ctrl+ZUndo
Ctrl+YRedo
Navigation & Search
ShortcutAction
Ctrl+GGo to line
Ctrl+FFind
F3Find next
F6Search & Replace (with regex support)
Arrow keys / Home / EndCursor movement
Page Up / Page DownScroll by page
Shift + Arrow keysExtend selection
File Operations
ShortcutAction
F2New file
Ctrl+OOpen file
Ctrl+SSave
F5Save as…
Ctrl+QQuit editor
Tools & Panels
ShortcutAction
F10File Explorer
F4Diagnostics / Linter panel
F9Git menu
F7AI Assistant panel
F1Show Keyboard Shortcuts
EscClose current panel
InsertToggle Insert / Overwrite mode
Pro tip: Press any key while this help screen is open to close it.

Frequently Asked Questions

Get clear, honest answers about Ecli from a real terminal developer's perspective.

Download Ecli v0.1.3

Latest stable release v0.1.3 for macOS 12+ (recommended), Windows 10+, Linux, and FreeBSD.

Windows
Windows 10+
x64 / ARM64
macOS
macOS 12+ recommended
Intel / Apple Silicon
Linux
Most distributions
x64 / ARM64
FreeBSD
FreeBSD package target
.pkg
Installation on Debian 13 and Newer Debian/Ubuntu Releases
Debian 13 uses a strict externally-managed-environment policy. When installing with pip, you may see:
error: externally-managed-environment

1. Use pipx (Recommended for end users)

sudo apt update
sudo apt install pipx
pipx install ecli-editor

2. Use a virtual environment (Best for development)

python3 -m venv ~/.local/ecli-env
source ~/.local/ecli-env/bin/activate
pip install ecli-editor

# To run Ecli:
ecli

3. Use the official .deb package when available

The official GitHub Releases .deb package bypasses the Python package-management conflict entirely.

4. System-wide pip install (Not recommended)

pip install ecli-editor --break-system-packages

Warning: this can conflict with Python packages managed by apt. Use it only when you understand the system-level trade-off.