Repository navigation
Agneta 0.3.0
You choose which of your plans and API keys an app may use; the app picks the engine. A 19 MB download, downloads you can follow, and calmer windows.
Updating from 0.2.0: this version reads none of 0.2.0's data. After the update Agneta asks you to reset; then connect your plans and keys again, and apps ask for access again. Until 1.0, versions don't carry data or protocol details over.
For you
- Apps choose the engine; you choose what they may use. The approval window asks only which providers (your plans and API keys) an app may use. Every engine is allowed unless you narrow them under Advanced, and Settings → Apps changes both later. Settings → Engines sets each provider's default engine, used when an app doesn't pick, and shows each engine's source, version, install and download. Settings → Accounts is now Providers.
- No provider yet? An app that asks before any is connected gets a window to connect one there, and it's ticked. A provider whose engine isn't installed yet can still be allowed; its row says what it needs.
- One grant per app. Always Allow for an app that has access already renews it, keeping its workspace and tasks, instead of listing it twice; the window says so.
- Downloads you can follow. OpenCode, Claude Code's adapter and Codex's runtime show their progress in the panel and in Settings; a failed download says why, with Try Again, and can be put away. Downloads are checked against their pins at every launch, whole, off the main thread.
- A 19 MB download (59 MB in 0.2.0). Codex's runtime (Node and codex-acp) is a download of its own, fetched the first time a ChatGPT plan or an app needs Codex.
- Steadier engines. A default engine whose download failed no longer keeps tasks waiting while another engine can run.
- ChatGPT sign-ins stay in the Keychain, not in a file Codex's own tools could read during a task. Sign Out and Reset remove them.
- Calmer windows. Dialogs keep their close button and buttons clear of their rounded corners, and filled buttons are easier to read in dark mode; the menu bar panel no longer shows a square outline; Agneta says provider, not account, for what it connects.
For apps (APP_PROTOCOL.md)
agneta/accessreturns the providers and engines an app may use, each engine's state on this Mac (ready, downloading, downloadable, failed or unavailable, and why);initialize(_meta.agneta.access) and pairing return the same, andagneta/accessChangedsays when it changes.session/newtakes_meta.agneta.engine; a refusal carries the current access. An engine that isn't here starts downloading when asked for (-32015, with the progress).- Pairing's result says whether access is
remembered: keep that token and reconnect with it;-32001means the user removed access. - Model and reasoning effort: each engine's own settings, found by their ACP categories (
model,thought_level), set withsession/set_config_option. Tried on Codex, Claude Code, Goose and OpenCode. - When Agneta isn't running, ask the user and open
agneta://open(agneta-dev://openfor a development build). - Breaking: extension names lose their
@1(agneta/policy,agneta/task,agneta/usage, …);_meta.agneta.accounts,scopeandworkspaceininitializemoved intoaccess;engineUnavailableandengineChangedare gone (a saved task whose engine stores sessions differently reportsstateChanged). - The Project Chat example shows all of it: it keeps its access, offers to open Agneta, and has provider, engine, model and effort pickers.
Install
| Your Mac | Download |
|---|---|
| Apple silicon (M1 or later) | Agneta-0.3.0-arm64.dmg |
| Intel | Agneta-0.3.0-x86_64.dmg |
Not sure which you have? Choose Apple menu → About This Mac: Chip: Apple M… means Apple silicon, Processor: … Intel means Intel.
- Open the DMG and drag Agneta into Applications.
- Open Agneta from Applications. It lives in the menu bar (the linked rings beside the clock), not in the Dock.
- Click the menu bar icon and connect a provider: a ChatGPT plan (needs Codex 0.166 or later), a Claude plan (needs Claude Code; the Claude desktop app includes it), or an OpenAI or Anthropic API key.
- To see what an app does with it, choose Run a Test Task from the panel's ⋯ menu.
Or install with Homebrew:
brew install olofd/tap/agnetaNeeds macOS 14 or later. Agneta is signed with a Developer ID and notarized by Apple, so it opens without a warning.
Updates
Agneta asks before it first checks for updates. After that it checks GitHub about once a day, and installs an update only when no task is running. Check for Updates… is in the panel's ⋯ menu; Settings → General turns automatic checks or installs off. Homebrew leaves updating to Agneta.
For app developers
Apps connect at ws://127.0.0.1:47321/acp and pair once. Start with the README's guide, the Project Chat example and the app protocol.
Check a download
SHA256SUMS.txt lists every file's SHA-256, and GitHub records how each was built:
shasum -a 256 -c SHA256SUMS.txt --ignore-missing
gh attestation verify Agneta-0.3.0-arm64.dmg --repo olofd/agnetaThe other files are for Agneta itself: the .zip files and appcast-*.xml for its updater, and Agneta-codex-runtime-… (Node and codex-acp), which it downloads the first time a Codex account is used. You don't need them. Problems and questions go to Issues; security reports go privately through the Security tab.