# Agent!

A macOS app that uses AI providers to carry out coding tasks and automate desktop actions.

> This is the Markdown version of the Agent! page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/agentiloop-agent>

- **Latest version**: `1.1.99.299`
- **Developer**: AgentiLoop
- **Homepage**: <https://github.com/AgentiLoop/Agent>
- **Categories**: [AI Tools](https://opennavo.com/categories/ai)
- **Install**: `brew install --cask agentiloop-agent`
- **30-day installs**: 32
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/AgentiLoop/Agent/releases/download/v1.1.99.299/Agent-v1.1.99.299-macOS.dmg>
- **SHA-256**: `1ac9293ffb4727e4237258c9df1eeaced9f484205ec771da372306df1c1d7df0`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "Agent!.app"
      ],
      "target": "/Applications/Agent!.app"
    },
    "phase": "install",
    "sources": [
      "Agent!.app"
    ],
    "target": "/Applications/Agent!.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Caches/Agent.app.toddbruss",
            "~/Library/HTTPStorages/Agent.app.toddbruss",
            "~/Library/HTTPStorages/Agent.app.toddbruss.binarycookies",
            "~/Library/Preferences/Agent.app.toddbruss.plist"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Agent! is a native macOS app that connects AI providers and Apple Intelligence to an autonomous task workflow. It can work with codebases, edit files, build Xcode projects, manage Git, and interact with Mac apps through Accessibility and AppleScript-based automation.

- **Task execution:** Runs a loop that observes results and can revise its actions; task completion can be checked against stated criteria.
- **Coding tools:** Supports code editing, Xcode project builds, Git operations, change snapshots, and rollback.
- **Mac automation:** Can operate apps through Accessibility, AppleScript, and JavaScript for Automation (JXA). It also provides shell execution options.
- **Provider choice:** Connects to multiple AI providers; the project also describes on-device Apple Intelligence support. Provider setup may require an API key, depending on the provider.
- **MCP and task organization:** MCP servers can be configured in Settings, and the app includes tabs with separate project folders and logs.

Install the Homebrew cask with `brew install --cask agentiloop-agent`, then open Agent! and choose a provider in Settings. The supplied cask targets 64-bit Apple Silicon, and the app requires macOS 14.6 or later. This is the graphical Agent! app, not the separate AgentiLoop CLI project.

[Official project](https://github.com/AgentiLoop/Agent) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/a/agentiloop-agent.rb)

## System requirements

- macOS 14 or later · Version: 1.1.99.299 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/agentiloop-agent.rb> · Checked 2026-11-22
  - <https://github.com/AgentiLoop/Agent/releases/download/v1.1.99.299/Agent-v1.1.99.299-macOS.dmg>
  - SHA-256: `1ac9293ffb4727e4237258c9df1eeaced9f484205ec771da372306df1c1d7df0`

## Uninstall

- `brew uninstall --cask agentiloop-agent`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask agentiloop-agent`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Caches/Agent.app.toddbruss` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/agentiloop-agent.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/Agent.app.toddbruss` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/agentiloop-agent.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/Agent.app.toddbruss.binarycookies` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/agentiloop-agent.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/Agent.app.toddbruss.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/agentiloop-agent.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.1.100.300-prerelease (2026-11-22)

#### Agent! 1.1.100 (build 300) — Pre-release

This is a **pre-release** from `main`, tagged `v1.1.100.300`. It builds on [`v1.1.99.299`](https://github.com/AgentiLoop/Agent/releases/tag/v1.1.99.299) with a new Web Search tool, a new app icon and README updates.

##### 🔍 Web Search
- **Web Search toolbar button:** a new toolbar icon opens a Web Search popover with the SpecStream, Exa and Tavily keys ([`54e9b391`](https://github.com/AgentiLoop/Agent/commit/54e9b391))
- **SpecStream search provider:** uses the `speed=fast` tier and parses the answer object from the search API ([`54e9b391`](https://github.com/AgentiLoop/Agent/commit/54e9b391), [`92902349`](https://github.com/AgentiLoop/Agent/commit/92902349))
- **Drag-and-drop Search Tool Order:** SpecStream, Exa, Tavily, Ollama Web Search, Z.AI Web Search and DuckDuckGo. The top tool is preferred and the rest are tried in order if it fails. Tools without a key are skipped, and Ollama and Z.AI no longer jump ahead just because they're the current LLM ([`9bbae4ef`](https://github.com/AgentiLoop/Agent/commit/9bbae4ef))
- **Claude Web Search:** shown as a fixed row when the current tab's LLM is Claude ([`75797e75`](https://github.com/AgentiLoop/Agent/commit/75797e75), [`d506170c`](https://github.com/AgentiLoop/Agent/commit/d506170c))
- **Stats and history:** the popover shows which search tool was last used, per-tool ok/error counts with the last error, and Recent Searches ([`17cdbaf9`](https://github.com/AgentiLoop/Agent/commit/17cdbaf9), [`78aa9bdc`](https://github.com/AgentiLoop/Agent/commit/78aa9bdc))
- **Recent Searches rows:** show the top result as a title, a clickable link and a short description ([`1f2241ee`](https://github.com/AgentiLoop/Agent/commit/1f2241ee))
- **Activity log:** names the search tool that ran, on every tab, e.g. `🌐 Web search backend: SpecStream` ([`17cdbaf9`](https://github.com/AgentiLoop/Agent/commit/17cdbaf9), [`c6773f65`](https://github.com/AgentiLoop/Agent/commit/c6773f65))

##### 🐛 Fixed
- Claude uses only its own built-in web search on the Anthropic API. Before, it was also sent the app's search tool and sometimes used that or Safari instead ([`f87534f2`](https://github.com/AgentiLoop/Agent/commit/f87534f2))
- Claude's own web searches are now recorded in the Web Search stats, history and activity log ([`a82c53ae`](https://github.com/AgentiLoop/Agent/commit/a82c53ae))
- The search tool no longer tells the model it's "via Tavily", and Safari is only used for searches when you ask for a browser ([`f87534f2`](https://github.com/AgentiLoop/Agent/commit/f87534f2))
- ClaudeService: invalid or overlong `tool_use` names in history are cleaned up to avoid a 400 error ([`cb1d24c8`](https://github.com/AgentiLoop/Agent/commit/cb1d24c8))

##### 🎨 UI
- New app icon: four light circles inside a dark blue circle, with larger dots and a brighter blue ([`a99ad7eb`](https://github.com/AgentiLoop/Agent/commit/a99ad7eb), [`6d126876`](https://github.com/AgentiLoop/Agent/commit/6d126876))
- Intro screen: shows the app icon, and the "Agent!" title is thinner ([`fa4facc9`](https://github.com/AgentiLoop/Agent/commit/fa4facc9), [`01f8722b`](https://github.com/AgentiLoop/Agent/commit/01f8722b))
- The Sponsors menu is hidden ([`63acc86d`](https://github.com/AgentiLoop/Agent/commit/63acc86d))

##### 📖 Docs
- README: 27 LLM providers (adds Fluxion AI, Muse Code and TheRouter) ([`d0949c88`](https://github.com/AgentiLoop/Agent/commit/d0949c88))
- README: a "What Agent! can really do" section and a games table, in all 8 languages ([`01b8290f`](https://github.com/AgentiLoop/Agent/commit/01b8290f), [`3bb9a0a0`](https://github.com/AgentiLoop/Agent/commit/3bb9a0a0), [`0da03e28`](https://github.com/AgentiLoop/Agent/commit/0da03e28))
- README: CLI v0.0.10, the `/auto` progress log and `--worktree`, 35 accessibility actions and about 70 AgentScripts ([`b7a515d9`](https://github.com/AgentiLoop/Agent/commit/b7a515d9), [`35af870d`](https://github.com/AgentiLoop/Agent/commit/35af870d))
- README: sponsors removed in all 8 languages ([`d794e85f`](https://github.com/AgentiLoop/Agent/commit/d794e85f))

##### 🔢 Version
- Bumped to 1.1.100 (300) ([`581d0503`](https://github.com/AgentiLoop/Agent/commit/581d0503))

##### 📦 Install
- Download the signed, notarized `.dmg` or `.zip` attached to this release. The Release workflow builds and staples them after publishing.

**Full changelog:** https://github.com/AgentiLoop/Agent/compare/v1.1.99.299...v1.1.100.300

## Facts and sources

- <https://opennavo.com/apps/agentiloop-agent>
- <https://opennavo.com/apps/agentiloop-agent/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/a/agentiloop-agent.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/agentiloop-agent>
