Check the prerequisites

• macOS 26.4 (Tahoe) or later on Apple Silicon
• Xcode Command Line Tools: xcode-select --install
• An LLM API key, or a local model via Ollama, vLLM, or LM Studio

Install with Homebrew

brew update && brew install --cask agentiloop-agent

• Installs Agent!.app into /Applications
• Update later with brew upgrade --cask agentiloop-agent

Or download the DMG

• Grab the latest release from GitHub
• Open the DMG and drag Agent! to /Applications
• Launch it from Applications or Spotlight

Register the background services

• Open Agent! and click Register
• This installs AgentUser (Launch Agent) and AgentHelper (Launch Daemon)
• Approve the root helper once when macOS prompts you

Login Items

• System Settings → General → Login Items & Extensions
• Allow Agent and AgentHelper under Allow in the Background

Accessibility

• System Settings → Privacy & Security → Accessibility
• Enable Agent! so it can click, type, and read UI elements in any app

Automation & Speech

• Approve per-app Automation prompts as they appear (Finder, Safari, Music, System Events, …)
• Allow Microphone and Speech Recognition if you want to say "Agent!" and speak your task

Full Disk Access (optional)

• Only needed for iMessage remote control, which reads chat.db
• System Settings → Privacy & Security → Full Disk Access → enable Agent!
• Then add your approved senders in Settings

Open Settings

• Click the ⚙️ icon in the toolbar
• Choose a provider from the picker
• Paste your API key and select a model

Cheapest starting point

• GLM-5.3 via Z.ai — fastest signup, pennies per million tokens
• Codex uses your ChatGPT subscription via OAuth — no API key
• Claude supports API key or subscription OAuth

Going fully local

• Point Agent! at Ollama, vLLM, or LM Studio — nothing leaves your Mac
• The real per-model context window is detected automatically
• A usable 30B+ model needs 64–128 GB of unified memory

Test the connection

• Click Connect to verify both XPC services respond
• Optionally add a fallback provider — Agent! auto-switches on 429, timeout, or network failure
• Add MCP servers under Settings → MCP Servers

Set a project folder

• Each tab has its own project folder and activity log
• Pick a folder so file, git, and Xcode tools know where to work

Type a task and press Return

• "Take a photo with Photo Booth"
• "Build the Xcode project and fix any errors"
• "Send an iMessage to Mom saying I'll be home at 6"

Watch it work

• Every tool call and result streams into the activity log
• Every file edit is snapshotted — roll back one edit or rewind the whole task
• ⌘ . or Esc cancels at any time

Go hands-free

• Say "Agent!" followed by your task — it runs after ~2.5s of silence
• Text Agent! next song from your iPhone via iMessage
• ⌘ T new tab · ⌘ F search log · ↑/↓ prompt history

Helpers won't register

• Expected on ad-hoc source builds — SMAppService needs a Team ID
• Install the signed release binary and click Register again

Accessibility actions do nothing

• Re-check Privacy & Security → Accessibility; toggle Agent! off and on after an update
• Approve the per-app Automation prompt for the target app

iMessage control not responding

• Grant Full Disk Access — Agent! needs to read chat.db
• Make sure the sender is on the approved list in Settings

Building from source

• Wrong xcode-select: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
• Odd BUILD FAILED after pulling: ./build.sh clean && ./build.sh
• Full notes in the README