Repository navigation
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.