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