1 running
0/4
Gather this year's invoices into one folderBackground work
✓ Find invoices in DownloadsSort them by monthMove them to Documents
Read invoice_2026-02.pdf
Gather this year's invoices into one folderWaiting for you
Arslan wants to do something that needs your OK.
Run mv ~/Downloads/invoice_2026-*.pdf ~/Documents/Invoices/
A background job is asking
Run this outside the sandbox?
Commands normally write only inside Arslan's working folder. This one needs to change files elsewhere on your Mac.
Gather this year's invoices into one folderStopped
You said no, so nothing moved.
The invoices are still in Downloads. Ask again whenever you like.
Gather this year's invoices into one folderDone
Moved 31 invoices into Documents/Invoices. Every month from January to August has one — except June.
Open conversationClose
your turn — tap it
New in 0.1.63 · change course mid-reply, undo a turn →

Does the work.
Asks before it acts.

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.

v0.1.63 · macOS 11+ · Apple Silicon · signed & notarized · free · open source · bring your own model key

end-to-end · through your private iCloud
0Arslan servers in the middle
3answers for every command
30 minto approve, Mac or iPhone (0.1.61+; 300 s before)
153service modules, all open
911test files guarding them

01How it works

One loop. Every step needs the one before it.

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

    What “it runs your terminal” actually means.

    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.

    arslan · terminal_policy.assess()
    ↑ ↓ to move
    —
    pure function · decided before it runs
    RUN

    Reading, listing, converting, building, fetching a page — inside a sandbox that can only write to your work folder, temp and caches.

    ASK

    Destructive, or acting outward in your name: deleting, force-pushing, other apps, mail, installs. Tick “don't ask again” for that kind of command.

    FORBID

    Never, even with a tick: wiping the disk or home folder, shutting down, keychain passwords, Arslan's own keys, sudo.

    03While you talk

    The conversation stays free. The work keeps going.

    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.

    Arslan Island

    Lives in the notch. Its face is the status: working, waiting for you, done.

    4 outcomes

    A job ends done, partial, blocked or stopped — never “quietly gave up”.

    No replays

    A schedule your Mac slept through is not fired late in a burst.

    Proposes only

    The heartbeat suggests; it never acts on its own.

    04Hands v2 in 0.1.60

    Hands for your Mac. Asked, not assumed.

    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.

    Mac apps Arslan Hands

    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.

    delete · send · pay · buy · submit → asks every time

    Browser

    Arslan's own browser reads pages freely; clicking and typing ask. Your Safari or Chrome is only ever read.

    asks once per site, per job

    Shortcuts & AppleScript

    Runs the Shortcuts you built. Scripts your apps when nothing else can — and you read the script first.

    every AppleScript shown in full
    Seen and stoppable

    A labelled cursor shows what it's doing. The Island shows the step, the time left and a thumbnail of the window, with a Stop button. The menu bar has “Stop Arslan's hands”. Activity keeps seven days of Hands actions — typed text only as its length.

    Never touchedKeychain Accesspassword managersSystem SettingsmacOS security promptsNotification CenterArslan itself
    types into a password fieldhands a model key to a commandruns a script you haven't seenclicks through Finder to move files — that's a command

    05Mac + iPhone

    Your Mac does the work. Your pocket holds the leash.

    Arslan for iPhone talks to the Arslan on your Mac — from anywhere, through your own private iCloud, encrypted end to end.

    coming to the App Store

    Arslan for iPhone

    Ask from anywhere, follow every job, and approve or deny in one tap. The Mac side ships in 0.1.53 — Settings › iPhone.

    No server of ours. Not even a relay.

    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.

    X25519key agreement
    HKDF-SHA256derive
    ChaCha20-Poly1305seal
    Ed25519sign
    iCloud · ArslanBridgeyour private DB

    First answer wins

    The same approval card shows on both. Whichever you tap first decides.

    iPhone · Approve0:41
    Mac · same cardclosed
    nobody answers30:00, not a no · 0.1.61+

    Always one glance away

    Menu bar, the Island in the notch, push-to-talk. It stays resident, recovers itself, and updates are signed.

    menu barIslandpush-to-talksigned updates

    The Island face, live

    The same mascot logic the app runs — the mouth constellation carries the state. Pick one.

    06Privacy & honesty

    Your Mac keeps it. The rest sees less.

    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.

    This Mac · SQLiteeverything
    Your model providerthe turns you send, on your key
    iCloud · iPhone linkciphertext + routing
    Arslan's serversnone exist

    What they actually see · tap a row

    The promise guard

    Send the deck to the team when it's ready.
    “Done — I've sent it, it's in their inboxes now.”
    0 TOOL CALLS · CAUGHT

    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

    Eight subsystems. One loop. All gates on.

    08Open source, shipped in the open

    The latest releases. Every one signed and notarized.

    • 0.1.63 ↗Oct 27 · latestChange course, undo a turn. Type while it works and it reads you at the next step, answers appear as they are written, and “Undo this turn” puts the folder back. Every new command asks first.
    • 0.1.62 ↗Oct 18Long commands finish. A command runs to its own limit, “needs your check” only when something may really have happened, a bad MCP tool no longer breaks a chat.
    • 0.1.61 ↗Oct 14One approval card everywhere. Same card in the chat, Inbox, Island and iPhone; MCP servers start by themselves; Claude works again.
    • 0.1.60 ↗Oct 11Hands v2. Sees the one window it works in, batches steps, borrows the front for a second, takes over only with your yes.
    • 0.1.59 ↗Oct 10A chat that keeps up. Long answers aren't cut off, a second message waits its turn, replies come in your language.
    • 0.1.58 ↗Oct 9Replies you can read, files you can open. One quiet line of what it did, files back as cards, a reader, any model you like.

    Honest limitations

    • Pre-v1. macOS 11+ on Apple Silicon only, for now.
    • Bring your own model key — your provider bills you.
    • The gate guards against mistakes and smuggled instructions; it is not a cage. A command you allow runs with your permissions.
    • The sandbox limits where commands write, not where they connect — Arslan reads the web with it.
    • By default every new command asks first, and scheduled tasks run no commands (0.1.63).
    • Hands can't click at a screen position or drag yet, and a key typed in the instant an app jumps forward (about 50 ms) goes to that app.

    Give it something to do.

    free · Apache-2.0 · github.com/mirzatghayrat/arslan