OneAgent

One place to install, configure, and keep your AI coding Agents ready.

简体中文

OneAgent is a local desktop workspace for AI coding Agents. It turns a fresh machine into a usable, repeatable setup without asking you to edit several tool-specific config files by hand.

What it does

• Detects, installs, updates, and launches supported CLI and desktop Agents.
• Connects Agents to built-in or custom Providers, with model selection and protocol-aware connection checks.
• Saves reusable Profiles and applies the right configuration to each Agent.
• Bootstraps required runtimes such as Node.js, uv, and Aider's managed Python when needed.
• Keeps long-running installs visible and cancellable in the Task Center.
• Imports and exports Providers and Profiles, with API keys excluded by default and optional password-protected export.
• Creates backups, writes atomically, and keeps credentials in private local storage.
• Checks for OneAgent updates and installs release artifacts through the built-in updater.

Supported Agents

PPIO and Novita are built in. Any OpenAI-compatible or Anthropic-compatible Provider can be added from the Provider page. OneAgent probes the protocol an Agent actually uses; an endpoint that only exposes a different API is rejected before configuration is written.

Download

Download the latest macOS or Windows installer from GitHub Releases. Release artifacts include SHA-256 checksums. The current channel is technical-preview-unsigned while Wails remains in Alpha; platform signing and notarization are not yet provided.

OneAgent does not redistribute Agent packages and does not bundle Node.js, Git, WebView, or API keys. Missing prerequisites are reported with a link to the official installation instructions.

Build from source

Requirements: Go, Node.js, pnpm 11.20.0, and the target platform's WebView dependencies.

git clone https://github.com/MaimoryLab/OneAgent.git
cd OneAgent
cd frontend && pnpm install --frozen-lockfile && pnpm run build && cd ..
go run -tags wails ./cmd/oneagent-desktop

For the usual development loop, install Task and run task dev. Useful checks:

go test ./...
go test -race ./...
go vet ./...
cd frontend && pnpm run test && pnpm run build

Project links

• AI Agent Kit: set up an Agent environment step by step
• Documentation: specifications and architecture decisions
• Public site repository
• Issues and feature requests

Star History

Sponsors

OneAgent is released under the Apache License 2.0. Third-party notices are listed in NOTICE.