What is ECA ?
ECA (Editor Code Assistant) is an open-source, editor-agnostic tool designed to unify Large Language Model (LLM) capabilities directly within your development environment. By leveraging a robust, LSP-inspired protocol, ECA eliminates friction in AI pair programming, ensuring you receive consistent, powerful assistance regardless of the editor you prefer. It solves the critical problem of fragmented AI toolchains, providing developers with a single, highly configurable gateway to agentic LLM workflows.
Key Features
⚙️ Editor-Agnostic Consistency
ECA utilizes a server-in-the-middle architecture, similar to the successful Language Server Protocol (LSP), to communicate with any integrated editor (VSCode, Emacs, IntelliJ, Vim). This approach ensures that once you establish a single configuration (global or local), the behavior and user experience of your AI assistant remain identical across all your workspaces and team environments, simplifying onboarding and reducing context switching.
☕ Powerful Agentic Behaviors and Tooling
Move beyond simple chat interactions. ECA allows the LLM to function as a true coding agent by integrating native and custom tools. Built-in tools provide access to core functions like Filesystem (reading/writing/moving files), Shell execution, and Editor operations. This tooling enables the LLM to autonomously perform complex tasks like refactoring, adding features, or debugging, subject to configurable approval settings.
💉 Deep Context and Project Awareness
Achieve higher quality LLM output by giving your assistant detailed project context. ECA supports passing specific files (#), directory contents, cursor position, and even external resources directly into the LLM prompt. Crucially, the system automatically includes the AGENTS.md file (which you can initialize with the /init command), allowing the LLM to instantly grasp your project standards, architectural patterns, and coding conventions.
🚀 Unified Multi-Model Access
ECA acts as a central hub for all your preferred LLM providers. Easily log in and switch between models from major providers like OpenAI, Anthropic, and GitHub Copilot, or integrate self-hosted local models via Ollama. This capability allows you to select the best model for specific tasks without needing separate configurations or plugins for each one.
📈 Built-in Telemetry and Observability
For teams and power users, ECA incorporates OpenTelemetry support. This feature allows you to export detailed metrics regarding tool usage, prompt effectiveness, and server activity. You gain crucial insights into how AI is being leveraged in your workflow, enabling better debugging, optimization, and cost monitoring.
Use Cases
1. Automated Feature Implementation and Refactoring
Instead of manually copying code snippets, you can use ECA's agent behavior to handle complex structural changes. For instance, you can instruct the LLM to "Implement OAuth login using the existing database schema." The agent will use its native tools (eca_read_file, eca_write_file) to identify relevant files, plan the changes (which you can preview using the plan behavior), and execute the code modifications directly within your workspace, significantly accelerating development cycles.
2. Standardized Project Onboarding
When bringing a new developer onto a project, you can leverage the AGENTS.md context file. This file defines project standards, common dependencies, and setup instructions. By running /init, you ensure that every developer's ECA session—regardless of their preferred editor—starts with immediate, deep context about the codebase, drastically reducing the time required to become productive.
3. Focused Code Review and Troubleshooting
Quickly troubleshoot a bug by providing the LLM with focused context. Instead of copying large files into a web chat, you can use the @ context area within ECA's chat interface to instantly pass in the contents of a specific file or directory. For example, you can ask, "Why is this function failing?" while simultaneously providing the relevant file content and cursor position, leading to highly accurate and actionable diagnostics.
Conclusion
ECA provides the unified, powerful, and flexible AI pair programming environment necessary for modern software development. By delivering editor-agnostic consistency and robust agentic capabilities rooted in deep context, ECA helps you maximize the power of current and future LLMs directly within your preferred development workflow.





