ecli

The Next-Gen Terminal IDE www.ecli.io
A modern, AI-powered, extensible code editor for the terminal.

🚀 About Ecli

Ecli (short for Editor CLI) is a next-generation terminal IDE. It brings the power of modern development tools into your terminal - fast, extensible, AI-ready.

✨ Key Features

• 🧠 AI Panel - integrated assistant for code, docs, and refactoring

• 📂 File Manager - navigate and manage projects seamlessly

• 🌱 Git Panel - stage, commit, push/pull directly in terminal

• 🌈 Syntax Highlighting - powered by Tree-sitter, supports 70+ languages

• 📝 LSP Integration - full Language Server Protocol support (autocomplete, diagnostics, go-to-definition)

• 🐍 Built-in Linters -

  • Ruff (Python) integrated by default
  • Support for external linters across 70+ languages

• ⚡ Extensible Architecture - plugins & themes

• 🎨 Dark/Light Themes out of the box

• 🔄 Cross-platform: Linux, macOS, and FreeBSD

---

📦 Installation

1. System Dependencies

First, ensure you have the required system libraries installed. These are necessary for the terminal interface, clipboard integration, YAML acceleration, and testing with full UTF-8 support.

Click to see installation commands for your OS

On Debian/Ubuntu:

sudo apt update && sudo apt install \
  libncurses6 \
  libncursesw6 \
  libtinfo6 \
  libncurses-dev \
  libncursesw5-dev \
  ncurses-bin \
  ncurses-term \
  libyaml-dev \
  xclip \
  xsel

On Fedora/CentOS/RHEL:

sudo dnf install ncurses ncurses-devel libyaml-devel xclip xsel

On Arch Linux:

sudo pacman -S ncurses libyaml xclip xsel

On FreeBSD:

sudo pkg install ncurses libyaml xclip xsel

These dependencies ensure:

• ✅ Full curses (UTF-8, wide-char, colors) support
• ✅ wcwidth correct behavior
• ✅ PyYAML C bindings for faster parsing
• ✅ Clipboard support for pyperclip

2. Install ECLI

You can install ECLI using a pre-compiled package (recommended) or with pip.

Option A: From a Package (Recommended)

Download the appropriate package for your system from the GitHub Releases page, then run the command for your OS.

On Debian/Ubuntu:

# Replace with the actual downloaded filename
sudo apt install ./ecli-0.1.0_amd64.deb

On Fedora/CentOS/RHEL:

# Replace with the actual downloaded filename
sudo dnf install ./ecli-0.1.0-1.x86_64.rpm

On FreeBSD:

# Replace with the actual downloaded filename
sudo pkg install ./ecli-0.1.0.pkg

On Arch Linux:

The recommended method for Arch Linux is to install from the Arch User Repository (AUR). Once the package is available on the AUR, you can install it using an AUR helper like yay:

yay -S ecli

(Note: The ecli package must be submitted to the AUR first.)

Option B: With pip

This method requires you to have Python 3.11+ and pip installed, in addition to the system dependencies mentioned above.

pip install ecli