Editora 0.19.0 docs. You are reading an archived version, kept so links from that release keep working. Read the 0.21.0 docs →

Beta AI assistance

Editora has optional AI, off by default and yours to configure. It comes in two parts: quick one-shot actions, and a full embedded agent.

Turning it on

1. Turn on Enable AI in Settings → AI (or view.toggleAiEnabled). This master switch gates everything on this page: while it is off, every AI feature is disabled whatever its own setting says.
2. Turn on the part you want: AI Actions (view.toggleAi), the AI Agent (view.toggleAgent), or both.
3. For AI Actions, choose a provider, give it a key or an endpoint, and run AI: Test Connection (ai.testConnection). For the agent, install an ACP agent and check its command under Settings → AI Agent.
4. Inline completion has its own switch under AI Actions (view.toggleAiCompletion) and stays off until you turn it on.

AI actions

These call the model directly (streamed), enabled under Settings → AI Actions:

There’s also inline completion: after a typing pause, a muted one-line ghost suggestion appears at the caret, and Tab accepts it. It uses its own fast model (default claude-haiku-4-5), separate from the action model (default claude-opus-4-8).

AI Agent

The AI Agent is a chat with an embedded coding agent over the Agent Client Protocol (ACP). The default is Claude Code’s claude-code-acp adapter, but any ACP agent works (Settings → AI Agent). The agent is a user-installed external tool, never bundled.

• Its file reads see your open buffers’ unsaved text.
• Its edits to open files apply as undoable buffer edits that you review and save.
• Each action that needs permission pops a dialog.
• Its file reads and writes are confined to the session folder, and can never touch Editora’s own configuration.
• Replies appear as they stream. Remote images in a reply are not loaded; the alt text and URL are shown instead.

Commands: tool.agent (the tool window), agent.newSession, agent.resumeSession, agent.selectClient, agent.selectMode, agent.selectModel, agent.stop. AI is gated behind a master Enable AI switch (off by default) in Settings → AI.

Providers

Pick a provider in Settings:

• Anthropic API: the API key comes from the ANTHROPIC_API_KEY environment variable or a Settings override; models are configurable.
• Local (OpenAI-compatible): point every AI feature at LM Studio, Ollama, or any local OpenAI-compatible server, with no API key and a configurable endpoint.
• LM Studio / Bionic: a separate local provider with its own endpoint, action model, inline model, and optional token. It can also supply the model for the OpenCode ACP agent preset without writing OpenCode config files.
• Codex: use the user-installed codex-acp adapter and an existing Codex login for Explain, Rewrite, and commit-message generation. These actions use separate text-only sessions and leave your Agent chat intact. Inline completion is unavailable with this provider; its API key and endpoint settings are ignored.

When AI Actions are enabled and connected, the editor right-click menu includes AI Actions → Explain and Rewrite. Generated explanation.md buffers show the provider and response model when the server reports it.

Each provider has its own stored key: the Settings key field shows only the selected provider’s, and a key set for one provider is never sent to another’s endpoint. The ANTHROPIC_API_KEY fallback applies only to the Anthropic provider. And Editora won’t attach a key to a plain-http:// endpoint on another machine, refusing before it connects and asking you to use https or a loopback address, so your key never crosses the network in the clear. Plain-http on 127.0.0.1 (the usual local-inference path) is unaffected.

A key typed into Settings, for any provider, is saved in settings.json in your config folder as plain text. On a shared machine, leave the Anthropic field empty and set ANTHROPIC_API_KEY in your environment instead.

What leaves your machine

AI Actions send the following to the provider you selected: Anthropic’s API, the endpoint you configured for a local or LM Studio provider, or the codex-acp adapter running on your machine for Codex.

• Generate commit message sends the staged diff (git diff --cached).
• Explain sends the selected text and the file’s language name.
• Rewrite sends the selected text, the language name, and your instruction.
• A diff or selection longer than 120,000 characters is cut at that length.
• Inline completion sends the language name and the text around the caret, up to 4,000 characters before it and 1,000 after, once per typing pause. It only asks when the caret is at the end of a line.

The AI Agent gets your prompt. With Include editor context in prompts on (the default; view.toggleAgentContext), each prompt is also prefixed with the active file’s path, the cursor line, and the first 200 characters of any selection. Anything else the agent reads, it requests itself, within the limits listed under AI Agent.

Related

For letting an external agent drive Editora (rather than Editora calling a model), see the MCP server.