🦾 Agent! for macOS 26.4.1 or later

Agentic AI for your  Mac Desktop

README Translations

• English
• Español
• Français
• Deutsch
• 中文 (简体)

Chess within Agent

Backstory and the Tech behind Agent!

Agent! didn't come together overnight. It's the result of three years of building agentic AI apps, drawing on roughly a dozen projects developed along the way. Some of those were published under ANIE, Game Changer, BattleScript, XCF MCP Server and Client, D1F, and about eight original Swift Packages. The missing piece was achieving an intelligent autonomous time loop. Once achieved, I brought in the best of the best from the previous three years. The result is Agent! for macOS 26.4.1 or later.

The original goal was to build a Cursor killer. What emerged is something more interesting: an agentic AI with real legs. Agent! is only limited by your imagination. It can write code including video games like Boss-Man, https://github.com/macos26/bossman, create apps, write poetry via AppleScript within Pages, generate disk images, and attach them to GitHub releases. It can automate most tasks on your Mac. Ask it what you want in plain English or your native language and, after some initial configuration and user approvals, it will do everything it can to carry out your wish. Agent! is relentless, and aims to please.

All of Agent!'s IP is original and open source. Every Swift package dependency and the app itself were originally authored by the same person. This is a genuinely different ecosystem. Most agentic AI apps like Claude Code rely on 65 NPM packages from third parties. Agent! is 100% native, requires very little RAM, and weighs in at 35.5 uncompressed. That footprint includes Xcode automation, a Swift Syntax 6.2 package for troubleshooting native apps, Accessibility, AppleScript, AgentScript/ScriptingBridge, Safari automation, MCP Server support, and more. Out of the box.

What's New 🚀

v1.0.92 (186) — The Self-Verifying Autonomy Release · Full release notes →

Agent! now proves its work. A task can't declare itself done until its success criteria are verified with evidence (goal_state), an opt-in critic reviews the diff before completion, and every file touched can be rolled back in one shot (rewind_task). Extended thinking for Claude, reasoning_effort for OpenAI-compatible providers, and a prompt-cache-stable context that compacts to each model's real window — recoverably, with full tool results spilled to disk. Typed tool errors carry recovery hints, sub-agents run their own models (up to 6 read-only researchers), event hooks are fully wired, and 57 passing tests keep it honest.

One app. Any AI. Total command over your Mac.

Agent! wires 18 LLM providers — Claude, GPT, Gemini, Grok, Mistral, DeepSeek, Qwen, Z.ai, BigModel, Hugging Face, OpenRouter, Ollama (cloud and local), vLLM, LM Studio, Codestral, Mistral Vibe, and on-device Apple Intelligence — into a native macOS app that doesn't just talk about doing things. It does them.

Watch it read your codebase, fix the bug, build the Xcode project, and commit the diff while you make coffee. Tell it to open Safari and text you the price of flights to Tokyo. Say "Agent!" from across the room and have it run your test suite by voice. Text your Mac from iMessage and get a polished answer before you reach your car.

It edits files with surgical string-replace diffs — every change one-click undoable from a Time-Machine-style rollback. It drives any Mac app through the Accessibility API — no AppleScript required. It remembers your preferences across sessions. It spawns parallel sub-agents for work that fans out. It indexes entire codebases into a portable JSONL repo-map that any LLM can consume. It runs shell commands as you, or as root via a Launch Daemon you approve exactly once.

Bring your own API key. Run it fully local on Ollama, vLLM, or LM Studio. Or run it free, forever, on Apple Intelligence. No subscription. No telemetry. No vendor lock-in. Your keys, your machine, your data.

Download it. Say what you need. Watch it happen.

Quick Start (Download)

1. Download Agent! and drag to Applications
2. Open Agent! -- it sets up everything automatically
3. Pick your AI -- Settings → choose a provider → enter API key

Quick Start (Build from Source)

1. Clone the repository:

   git clone https://github.com/macos26/agent.git
   cd Agent
   

Option A: Build with Xcode (Apple Developer account)

2. Open Agent.xcodeproj in Xcode.
3. Build and Run the Agent target.
4. Approve the Helper Tool: When prompted, authorize the privileged daemon to allow root-level command execution.

Option B: Build without an Apple Developer account

2. Run the build script (requires only Xcode Command Line Tools):

   ./build.sh              # Debug build
   ./build.sh Release      # Release build
   

3. The app lands in build/DerivedData/Build/Products/Debug/Agent!.app
4. Run it: open "build/DerivedData/Build/Products/Debug/Agent!.app"

⚠️ Without a developer account the app is ad-hoc signed. The Launch Agent/Daemon helpers won't register (SMAppService needs a team ID), but the LLM loop, all tools, accessibility, AppleScript, shell, and MCP all work.

Then:

5. Configure your AI Provider: Go to Settings and enter your API key or select a local provider like Ollama.

💡 Cheap GLM setup: GLM-5.1 runs on all four cheap providers — Ollama, Hugging Face, Z.ai, BigModel — at pennies per million tokens. New here? Start with Z.ai (fastest signup, GLM-5.1 is the default, nothing to provision). Running locally? Only GLM-4.7-Turbo (32B) fits on consumer hardware (M2/M3/M4 Mac, 64-128GB, via Ollama) — GLM-5 and GLM-5.1 are too large (~1.6TB), use them via the cloud providers above.

Troubleshooting (Build from Source)

First-time builders of Option B hit a few predictable snags:

• xcode-select points at the Command Line Tools, not full Xcode. ./build.sh calls xcodebuild; if xcode-select -p prints /Library/Developer/CommandLineTools, xcodebuild can fail to resolve the project. Point it at a full Xcode: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer (then xcodebuild -version to confirm).

• BUILD FAILED after pulling new changes (stale DerivedData). The build caches under build/DerivedData. When a stale cache causes odd, unrelated errors, wipe it and rebuild: ./build.sh clean && ./build.sh.

• The Launch Agent / Daemon helpers never register. Expected on Option B — the script builds ad-hoc signed (CODE_SIGN_IDENTITY="-", empty DEVELOPMENT_TEAM), and SMAppService needs a valid Team ID to register the helpers. The LLM loop, all tools, Accessibility, AppleScript, shell, and MCP still work. To get the helpers, use Option A (open Agent.xcodeproj in Xcode, set your own Development Team, Build & Run, and approve the helper when prompted).

• macOS / Swift version mismatch. Agent! targets macOS 26. If xcodebuild reports an unsupported deployment target or missing SDK, update to the required macOS and the matching Xcode before rebuilding.

• Wrong build configuration. The config argument is case-sensitive as the script uses it — ./build.sh (Debug) or ./build.sh Release. The app lands in build/DerivedData/Build/Products/<Config>/Agent!.app.

What Can It Do?

"Play my Workout playlist in Music" "Build the Xcode project and fix any errors" "Take a photo with Photo Booth" "Send an iMessage to Mom saying I'll be home at 6" "Open Safari and search for flights to Tokyo" "Refactor this class into smaller files" "What calendar events do I have today?"

Just type what you want. Agent! figures out how and makes it happen.

Key Features

🧠 Agentic AI Framework

Built-in autonomous task loop that reasons, executes, and self-corrects. Agent! doesn't just run code; it observes the results, debugs errors, and iterates until the task is complete. Goal state with evidence-verified success criteria means a task can't declare itself done until it proves it.

🛠 Agentic Coding

Full coding environment built in. Reads codebases, edits files with precision, runs shell commands, builds Xcode projects, manages git, and auto-enables coding mode to focus the AI on development tools. Replaces Claude Code, Cursor, and Cline -- no terminal, no IDE plugins, no monthly fee. Features Time Machine-style backups for every file change, letting you revert any edit instantly.

🔍 Dynamic Tool Discovery

Automatically detects and uses available tools (Xcode, Playwright, Shell, etc.) based on your p