Repository navigation
Releases
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.
Agneta 0.2.0
A smaller download, a choice of engine per app, an app icon, and fixes. Agneta is now about 60 MB to download instead of about 175.
Updating from 0.1.0: 0.1.0 can hang when it quits, and installing an update quits it. If the update seems stuck, quit Agneta from Activity Monitor (Force Quit): the update then installs, and 0.2.0 quits normally from then on.
- Choose the engine per app. When an app asks for access, each account you allow can run that app's tasks on another engine than the account's default, and Settings → Apps changes it later. Every account shows the engine it runs on, in the panel, the approval window and Settings. New accounts start on a sensible default (Codex for a ChatGPT plan, Claude Code for a Claude plan when it's installed, Goose for an API key), and adding one asks nothing about engines. Apps see the abilities of the engine they actually run on in
initialize; if that engine can't run,session/newsays so (engineUnavailable) (APP_PROTOCOL.md). - OpenCode downloads when you choose it (pinned and checked), instead of being bundled. If an account used OpenCode in 0.1.0, it downloads in the background after the update, and Settings shows the progress.
- An app icon: the two linked rings in ice white on winter-sea blue, a Liquid Glass icon on macOS 26.
- Quit Agneta quits. In 0.1.0 it could hang and leave the app unresponsive until force-quit.
- Check for Updates is always in the panel's ⋯ menu; a build that doesn't update itself says why.
- The menu bar panel is frosted glass, so what's behind it no longer reads through its text; Settings and task details keep their title bar, so scrolled content no longer runs into the title.
- Run a Test Task's pairing code opens as a normal, centred dialog that closes itself once you answer in Agneta.
- Security and robustness:
- A session's folders go into its sandbox exactly as they were checked, so a folder an app swaps for a symlink afterwards can't widen it.
- Policy limits are hard limits: an engine that ignores the cancel has its session ended after 10 s (APP_PROTOCOL.md).
- A limit outside the range of whole numbers is refused instead of crashing Agneta.
- Agneta never signals a process group once its engine's process number could belong to another program.
Install
| Your Mac | Download |
|---|---|
| Apple silicon (M1 or later) | Agneta-0.2.0-arm64.dmg |
| Intel | Agneta-0.2.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 an account: 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.2.0-arm64.dmg --repo olofd/agnetaThe .zip files and appcast-*.xml are for Agneta's updater; you don't need them. Problems and questions go to Issues; security reports go privately through the Security tab.
Agneta 0.1.0
The first public release, for macOS 14 or later on Apple silicon and Intel (tested on macOS 15 and 26). Download the DMG for your Mac below, or brew install olofd/tap/agneta. It is signed with a Developer ID and notarized by Apple.
- For people: connect ChatGPT or Claude plans (through your own Codex and Claude Code) and OpenAI or Anthropic API keys; approve which apps may use them, with the tools and folders each asks for, once or always; see and stop every task; Pause an account; remove an app's access; Reset everything.
- For apps: the Agent Client Protocol over a loopback WebSocket, with pairing, per-session policies (tools, folders, network, approval, limits) enforced or refused, steering, forking, resuming, usage in every result, and the task's trace, live or later (APP_PROTOCOL.md).
- Engines: Goose and OpenCode bundled, Claude Code and Codex from your own installs, each confined by a macOS sandbox profile, under one contract for the built-in tools each policy permits.
- Diagnostics: a structured trace per task,
agneta-diag, and an optional local MCP server for tools. - Updates: once you allow it, Agneta checks GitHub for new releases about once a day and installs one only when no task is running. Settings → General turns checks or automatic installs off.
Install
| Your Mac | Download |
|---|---|
| Apple silicon (M1 or later) | Agneta-0.1.0-arm64.dmg |
| Intel | Agneta-0.1.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 an account: 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.1.0-arm64.dmg --repo olofd/agnetaThe .zip files and appcast-*.xml are for Agneta's updater; you don't need them. Problems and questions go to Issues; security reports go privately through the Security tab.