Installing Agent! via Homebrew Cask — and other ways to work with the cask

[AgentiLoop]

Agent! is now available as an official Homebrew cask (merged into Homebrew/homebrew-cask in PR #287764). This post covers how to install it and the different ways you can work with the cask.

Install (official cask)

brew update
brew install --cask agentiloop-agent

That installs Agent!.app into /Applications. Requirements: macOS 26 (Tahoe) on Apple silicon — the cask declares depends_on arch: :arm64 and depends_on macos: :tahoe, so Homebrew will refuse to install on anything older.

Updating the cask index

Homebrew doesn't fetch the cask catalogue on every command — it uses a locally cached index. If you see No Cask with this name exists (or brew upgrade doesn't offer a release that's already on GitHub), the index is stale. Refresh it with:

brew update

brew update pulls the latest Homebrew/homebrew-cask (and any taps you've added, e.g. agentiloop/tap). If that still doesn't help, force a full refresh and check that the cask is visible:

brew update --force
brew search agentiloop
brew info --cask agentiloop-agent

Homebrew auto-updates in the background at most once a day; set HOMEBREW_NO_AUTO_UPDATE=1 if you'd rather run brew update yourself.

Alternative: the AgentiLoop tap

Before the official cask landed, Agent! shipped from our own tap. It is still maintained and is useful if you want a build that may land before the official cask bump goes through:

brew tap agentiloop/tap
brew install --cask agent

Note the cask name differs: agent in the tap vs. agentiloop-agent in homebrew-cask. Don't install both — you'll end up with two copies fighting over /Applications/Agent!.app.

Everyday cask operations

Task	Command
Check installed version / info	brew info --cask agentiloop-agent
Upgrade to the latest release	brew upgrade --cask agentiloop-agent
Upgrade every outdated cask	brew upgrade --cask
Reinstall (repair a broken copy)	brew reinstall --cask agentiloop-agent
Uninstall, keep settings	brew uninstall --cask agentiloop-agent
Uninstall and remove prefs/caches	brew uninstall --zap --cask agentiloop-agent
See what --zap would delete	brew cat agentiloop-agent (look at the zap trash: block)

--zap removes the app's preferences, caches and HTTP storage. It does not touch ~/Documents/AgentScript, so your agent scripts, system prompts and JSON I/O survive a zap.

Other ways to work with the cask

Brewfile / brew bundle — add it to a machine-setup manifest:

cask "agentiloop-agent"

then brew bundle install.

Skip Gatekeeper quarantine — if you'd rather not see the first-launch "downloaded from the internet" prompt:

brew install --cask agentiloop-agent --no-quarantine

Install to a different folder — brew install --cask agentiloop-agent --appdir=~/Applications.

Pinning — brew pin only works for formulae, not casks. To stay on a version, just don't run brew upgrade --cask agentiloop-agent; brew upgrade (no args) will still pick it up, so use brew upgrade --formula if you want to upgrade formulae only.

Version bumps — the cask has a livecheck block pointed at GitHub releases, so Homebrew's autobump bot opens a PR for each new tagged release automatically. If you see a release on GitHub that brew upgrade doesn't offer yet, the bump PR is probably still in flight; you can check open homebrew-cask PRs for agentiloop-agent.

No Homebrew at all — grab the .dmg or .zip from the latest release and drag to Applications.

Questions / feedback

If a cask install or upgrade misbehaves (checksum mismatch, wrong version reported, --zap missing a path), reply here or open an issue with the output of:

brew doctor
brew info --cask agentiloop-agent