Arslan is an AI agent that lives on your Mac. It runs your terminal, drives your apps and keeps working in the background while you talk — and keeps you posted from the notch, or from your iPhone. Anything that acts in your name waits for your click.
01How it works
A message enters one native tool loop. The model proposes; a fixed policy — not another model — decides. Every step below names the file that enforces it.
Enforced in
02The gate · try it
Every shell command gets one of three answers before it runs. Type one, or pick from the list — each of these 64 commands was run through Arslan's actual policy function. Nothing here is hand-labelled.
Reading, listing, converting, building, fetching a page — inside a sandbox that can only write to your work folder, temp and caches.
Destructive, or acting outward in your name: deleting, force-pushing, other apps, mail, installs. Tick “don't ask again” for that kind of command.
Never, even with a tick: wiping the disk or home folder, shutting down, keychain passwords, Arslan's own keys, sudo.
03While you talk
Long work moves into a background job and the turn ends. The Island in your notch shows what it's doing, asks when it needs you, and tells you when it's done.
Lives in the notch. Its face is the status: working, waiting for you, done.
A job ends done, partial, blocked or stopped — never “quietly gave up”.
A schedule your Mac slept through is not fired late in a burst.
The heartbeat suggests; it never acts on its own.
04Hands v2 in 0.1.60
Arslan can read and use the apps on your Mac — Notes, Mail, Pages and the rest — through a small helper, Arslan Hands. It reads a window as its accessibility tree — and, since 0.1.60, a picture of that one window, never the whole screen and never saved — and works in the background. When an app has to be in front, it borrows it for about a second while the screen edge glows blue, and gives it back. It takes over your screen only when you say yes, and pauses the moment you touch the keyboard or mouse.
Looking and acting ask once per app — one card can cover several apps, and apps you trust can be allowed for good. A chat reply acts for up to five steps; longer work runs in the background.
Arslan's own browser reads pages freely; clicking and typing ask. Your Safari or Chrome is only ever read.
Runs the Shortcuts you built. Scripts your apps when nothing else can — and you read the script first.
05Mac + iPhone
Arslan for iPhone talks to the Arslan on your Mac — from anywhere, through your own private iCloud, encrypted end to end.
Ask from anywhere, follow every job, and approve or deny in one tap. The Mac side ships in 0.1.53 — Settings › iPhone.
Messages travel through a CloudKit zone in your private iCloud database. Apple carries only ciphertext; delivered messages are deleted, and Arslan for Mac clears anything left over once it is more than 7 days old — it checks about daily while it is running and online.
The same approval card shows on both. Whichever you tap first decides.
Menu bar, the Island in the notch, push-to-talk. It stays resident, recovers itself, and updates are signed.
The same mascot logic the app runs — the mouth constellation carries the state. Pick one.
06Privacy & honesty
Memory lives in SQLite on your Mac, every entry stamped with when it took effect. Your model provider sees the turns you send, on your own key. Nobody else is in the middle.
What they actually see · tap a row
The promise guard
A deterministic check — not another model call — catches claims of work that never ran. One rewrite; if it promises again, an honest template goes out instead.
07The system map
08Open source, shipped in the open
Honest limitations