OpenAIDE

OpenAIDE runs coding Agents that support the Agent Client Protocol (ACP) and keeps each run as a Task you can inspect, stop, and return to.

A Task keeps the Agent's responses, tool calls, terminal output, permission requests, session configuration, and errors together. Work stays visible when a run fails or is interrupted, and OpenAIDE does not silently retry actions that may have changed your files.

The packaged extension runs inside VS Code. A local Web App is available when building from source. Both use the same Rust App Server and shared Frontend; Desktop and Mobile App Shells are planned, not included today.

Agents

Codex and OpenCode are built in. You can also add any ACP Agent that can be launched over stdio as a Custom Agent in Settings. The official ACP site keeps a list of Agents that support ACP.

OpenAIDE checks an Agent's capabilities before using optional features and marks unavailable operations as unsupported. For example, an Agent must support session discovery before OpenAIDE can find and adopt its existing sessions.

What it does

• Saves accepted Chat and Agent activity in local Task history.
• Shows streamed responses, folded tool details, terminal output, permission requests, and failures in their Chat order.
• Reopens saved Tasks and archives Tasks you no longer need in the main list.
• Finds and adopts existing Agent sessions when the Agent supports it.
• Stops running Tasks and can recover sessions left stuck after a crash.

When reporting a problem, run OpenAIDE: Export Support Diagnostics from the VS Code Command Palette and attach the redacted Support Export when possible.

Install the VS Code extension

In VS Code, open Extensions, search for OpenAIDE, and select Install.

For manual installation, download the VSIX for your platform from GitHub Releases. Testing builds are marked as prereleases on GitHub.

Platform	Release file
Linux x64	openaide-vscode-linux-x64-VERSION.vsix
Windows x64	openaide-vscode-win32-x64-VERSION.vsix
macOS Apple Silicon	openaide-vscode-darwin-arm64-VERSION.vsix

Other operating-system and CPU combinations are not currently packaged. VS Code 1.100 or newer is required.

Manual VSIX installation

1. Download the VSIX matching your platform.

2. In VS Code, run Extensions: Install from VSIX... and select the file, or install it from a terminal:

   code --install-extension path/to/openaide-vscode-PLATFORM-VERSION.vsix

3. Open the OpenAIDE activity-bar view.

4. Check Agent Settings, then create your first Task.

Codex and OpenCode must be authenticated separately. OpenAIDE first uses compatible Agent commands already on PATH and may fall back to npx, which requires Node.js, npm, and network access on first launch.

Each VSIX bundles the matching App Server executable. Standalone App Server, Web App archive, and container artifacts are not currently published.

Build from source

The local Web App launcher currently targets Linux and requires Bash and standard Linux process utilities. To build the workspace, install:

• Node.js 24 with npm
• the stable Rust toolchain
• VS Code 1.100 or newer when testing the extension

Install dependencies and verify the workspace:

npm ci
npm run check
npm run test
npm run build

Run the local Web App on loopback:

OPENAIDE_WEB_ALLOWED_HOSTS=localhost,127.0.0.1 npm run web:local

The default address is http://127.0.0.1:5474. Local deployment configuration can override it. Inspect the active address and logs with:

bash deploy/local-web.sh status
bash deploy/local-web.sh logs

Launch a VS Code Extension Development Host:

npm run vscode:launch

See CONTRIBUTING.md for the development workflow and required checks.

Repository layout

• openaide-rs/app-server: Rust App Server for Task state, ACP orchestration, persistence, and shell-neutral workflows.
• openaide-rs/app-server-protocol: typed App Server Protocol records and TypeScript binding generation.
• packages/app-server-client: shared TypeScript App Server client and generated protocol bindings.
• packages/app-shell-contracts: shared App Shell and Frontend contracts.
• packages/frontend: shared Task, Chat, navigation, and settings interface.
• apps/web: local Web App shell and browser bootstrap server.
• apps/vscode-extension: VS Code App Shell.

Releases

Pull requests are checked by GitHub Actions. A versioned tag builds Linux x64, Windows x64, and macOS Apple Silicon VSIX packages and creates a GitHub Release according to the release policy. Stable tags also publish those packages to the VS Code Marketplace and Open VSX; prerelease tags such as v0.0.1-alpha.1 remain GitHub prereleases.

Contributing and security

See CONTRIBUTING.md before opening a pull request. Report security vulnerabilities privately by following SECURITY.md.

License

OpenAIDE is licensed under AGPL-3.0-only. See LICENSE.