Acode AI Agent

A coding agent for Acode. It opens as an editor tab, reads and edits your project, searches the web, and runs shell commands on Terminal-backed folders. You connect your own model provider.

The agent core comes from Pi (@earendil-works/pi-durable and @earendil-works/pi-ai 1.0.4): providers, durable sessions, compaction, queues, retries, and the read, write, edit and bash tools. This plugin adds the Acode side: the editor UI, the workspace sandbox, approvals, and everything needed to run in an Android WebView without Node.

If you use Pi on a desktop, most of it carries over:

• Providers, models, thinking levels, API-key and device-code login
• Durable runs. Each model turn and tool call is saved before it is shown, so a run that Android interrupts can resume.
• Branches, compaction, steer and follow-up queues, fork, clone, /tree
• Skills and prompt templates (.pi/skills, .agents/skills, /skill:name, load_skill)
• Project instructions from AGENTS.md or CLAUDE.md
• Import and export of Pi CLI session files (JSONL)

What differs: files go through Acode’s fsOperation (local, SAF, FTP, SFTP), bash only exists on Terminal-backed folders, and OAuth uses Acode’s native browser and callback support. Pi packages, tmux and the Pi TUI are not included.

Requirements

• Acode version code 1002 or newer
• An open project folder (local, SAF, FTP or SFTP)
• An API key or subscription for a supported provider

There is no backend. Requests go straight to the provider you connect.

Install

From the plugin store: Settings → Plugins, search for Acode AI Agent, install and enable it.

From a zip: run npm run build (or download a release), then Settings → Plugins → + → LOCAL and pick plugin.zip.

Getting started

1. Open a project folder in Acode. The agent only works inside that folder.
2. Open the agent from the AI Agent sidebar app or the command palette (AI Agent: Open).
3. Tap ⋯ (top right) and add a provider. If you’re not sure which, an OpenRouter API key covers many models with one key.
4. Tap the chip in the composer (for example Ask · Med · ) to set:
   • Permission mode. Start with Ask so you approve every edit, delete and command.
   • Thinking level. Higher thinks longer and costs more. Med is a sensible default.
   • Model.
5. Ask for something. An empty chat offers starter prompts like Map the project and Review the open file.

Acode commands: