docs

Author: ericdallo

README.md

@@ -15,9 +15,10 @@ _Demo using [eca-vscode](https://github.com/editor-code-assistant/eca-vscode)_
 
 <hr>
 <p align="center">
-  <a href="#installation"><strong>installation</strong></a> •
+  <a href="./docs/installation.md"><strong>installation</strong></a> •
+  <a href="./docs/features.md"><strong>features</strong></a> •
   <a href="./docs/configuration.md"><strong>configuration</strong></a> •
-  <a href="./docs/capabilities.md"><strong>capabilities</strong></a> •
+  <a href="./docs/models.md"><strong>models</strong></a> •
   <a href="./docs/protocol.md"><strong>protocol</strong></a>
 </p>
 <hr>
@@ -37,22 +38,6 @@ A Free and OpenSource editor-agnostic tool that aims to easily link LLMs <-> Edi
 
 The protocol makes easier for other editors integrate and having a server in the middle helps adding more features quickly like exporting metrics of features usage or single way to configure it for any editor.
 
-## Installation
-
-Eca is written in Clojure and compiled into a native binary via graalvm. You can download the [native binaries from Github Releases](https://github.com/editor-code-assistant/eca/releases) or use the install script for convenience:
-
-Stable release:
-
-```bash
-bash <(curl -s https://raw.githubusercontent.com/editor-code-assistant/eca/master/install)
-```
-
-nightly build:
-
-```bash
-bash <(curl -s https://raw.githubusercontent.com/editor-code-assistant/eca/master/install) --version nightly --dir ~/
-```
-
 ## Usage
 
 Editors should spawn the server via `eca server` and communicate via stdin/stdout. Logs are printed to stderr, use `--verbose` to log client<->server communication or `--log-level debug`  to log more info like LLM responses.

docs/capabilities.md

@@ -0,0 +1,43 @@
+# Features
+
+## Chat
+
+Chat is the main feature of ECA, allowing LLM to behave like a chat, answering questions, or agent, making changes using tools.
+
+### Tools
+
+ECA leverage tools to give more power to the LLM, this is the best way to make LLMs have more context about your codebase and behave like an agent.
+It supports both MCP server tools + ECA native tools, for more details, check [configuration]().
+
+### Native tools
+
+ECA support built-in tools to avoid user extra installation and configuration, these tools are always included on models requests that support tools and can be [disabled/configured via config](./configuration.md) `nativeTools`.
+
+Some native tools like `filesystem` have MCP alternatives, but ECA having them built-in avoid the need to external dependencies like npx.
+
+#### Filesystem
+
+Provides access to filesystem under workspace root, listing and reading files and directories a subset of [official MCP filesystem](https://mcpserverhub.com/servers/filesystem), important for agentic operations, without the need to support NPM or other tools.
+
+- `eca_read_file`: read a file content.
+- `eca_write_file`: write content to file.
+- `eca_move_file`: move/rename a file.
+- `eca_list_directory`: list a directory.
+- `eca_search_files`: search in a path for files matching a pattern.
+- `eca_grep`: ripgrep/grep for paths with specified content.
+- `eca_replace_in_file`: replace a text with another one in file.
+
+#### Shell
+
+Provides access to run shell commands, useful to run build tools, tests, and other common commands, supports exclude/include commands. 
+
+- `eca_shell_command`: run shell command. Supports configs to exclude commands via `:nativeTools :shell :excludeCommands`.
+
+##  Completion
+
+Soon
+
+## Edit 
+
+Soon
+

docs/features.md

@@ -0,0 +1,15 @@
+# Installation
+
+Eca is written in Clojure and compiled into a native binary via graalvm. You can download the [native binaries from Github Releases](https://github.com/editor-code-assistant/eca/releases) or use the install script for convenience:
+
+Stable release:
+
+```bash
+bash <(curl -s https://raw.githubusercontent.com/editor-code-assistant/eca/master/install)
+```
+
+nightly build:
+
+```bash
+bash <(curl -s https://raw.githubusercontent.com/editor-code-assistant/eca/master/install) --version nightly --dir ~/
+```

docs/installation.md

@@ -0,0 +1,29 @@
+# Models
+
+## Built-in providers and capabilities
+
+| model     | MCP / tools | thinking/reasioning | prompt caching | web_search |
+|-----------|-------------|---------------------|----------------|------------|
+| OpenAI    | √           | X                   | X              | √          |
+| Anthropic | √           | X                   | √              | √          |
+| Ollama    | √           | X                   | X              | X          |
+
+### OpenAI
+
+- [o4-mini](https://platform.openai.com/docs/models/o4-mini)
+- [o3](https://platform.openai.com/docs/models/o3)
+- [gpt-4.1](https://platform.openai.com/docs/models/gpt-4.1)
+
+### Anthropic
+
+- [claude-sonnet-4-0](https://docs.anthropic.com/en/docs/about-claude/models/overview)
+- [claude-opus-4-0](https://docs.anthropic.com/en/docs/about-claude/models/overview)
+- [claude-3-5-haiku-latest](https://docs.anthropic.com/en/docs/about-claude/models/overview)
+
+### Ollama
+
+- [any local ollama model](https://ollama.com/search)
+
+## Custom providers
+
+ECA support configure extra LLM providers via `customProviders` config, for more details check [configuration](./configuration.md#custom-llm-providers).

docs/models.md

@@ -10,7 +10,7 @@ nav:
     - Overview: README.md
     - Configuration: configuration.md
     - Development: development.md
-    - Capabilities: capabilities.md
+    - Models: models.md
     - Protocol: protocol.md
   - Features: features.md
   - Installation: installation.md