Install
What you need
Section titled “What you need”- macOS 26 or later, on Apple Silicon.
- Git.
- Claude Code, Codex, the Antigravity CLI (
agy), OpenCode, or any of them together. Weir runs the copies you already have, signed in as you.
To see pull request status in the sidebar, also install gh or glab and sign in. Weir works without them.
Install
Section titled “Install”- Download the DMG from the latest release.
- Open it and drag
Weir.appto/Applications. - Open Weir.
The release is signed and notarized, so macOS does not block it as coming from an unknown developer. The first time, macOS asks you to confirm opening a downloaded app.
Weir registers a small background service for approvals. You will see it in System Settings → General → Login Items & Extensions. If you turn it off, approvals stay in each agent’s own prompt.
Next: run your first agent.
Update
Section titled “Update”Weir checks for updates once a day and installs one when you choose to. To check now, open the Weir menu and choose Check for Updates….
Uninstall
Section titled “Uninstall”- Quit Weir and move
Weir.appto the Trash. - Delete
~/Library/Application Support/Weir/and~/Library/Preferences/com.nekoder.Weir.plist. - If Login Items & Extensions still lists Weir, turn it off there.
- If you ran Antigravity in Weir and
~/.gemini/config/plugins/weirholds a file named.weir-managed, delete that folder. Without that file, the folder is not Weir’s. - If you ran OpenCode in Weir and
~/.config/opencode/plugins/weirholds a file named.weir-managed, delete that folder too.
Each repository also keeps Weir’s turn snapshots. To delete them, run this in the repository:
git for-each-ref --format='%(refname)' refs/weir/ | xargs -n1 git update-ref -dThen delete the weir folder in the directory git rev-parse --git-common-dir prints, and in each folder under its worktrees/.
Worktrees Weir made are ordinary Git worktrees. Remove the ones you no longer want with git worktree remove.