Mobile App

Updated July 4, 2026

The crystl mobile app is an iPhone companion to crystl for Mac. It pairs to a Mac you control and lets you watch your agents work, answer their questions, approve what they want to run, and keep a quest moving, all from your phone.

Available now. Download crystl on the App Store.

Everything happens between your two devices. Your code, terminal output, and conversations travel directly from your Mac to your phone: over your local network at home, or through an encrypted relay when you’re away. Nothing is stored on a server (see Privacy).

Pairing

The app has no account and no sign-in. You connect it to your Mac once:

  1. On the Mac, open Window → pair device. crystl shows a QR code and, if you’re connecting from outside your local network, a remote-access toggle.
  2. In the app, tap scan and point your phone at the QR code, or enter the host, port, and token by hand.

The pairing token is stored in your iPhone’s Keychain. Pairing and same-Wi-Fi use are free. To connect from outside your home network, enable remote access on the pair-device panel (Guild); traffic then routes through the encrypted relay to your Mac.

What you can do

Once paired, the app mirrors the parts of crystl you need when you’re away from the keyboard:

  • Browse your work. See every open gem (project) and its shards (sessions), with each agent’s live status.
  • Watch a session. Read the structured transcript of an agent’s turns, or switch to the live terminal screen.
  • Answer questions. When your agent asks a multiple-choice question, it appears right in the conversation: tap to answer, no tab-switching.
  • Approve tools. When your agent asks permission to run a tool, the request surfaces inline above the message box with allow, always, and deny, or review everything from the Approvals tab.
  • Send and steer. Type a message to your agent, with a terminal key row (enter, esc, ctrl-c, arrows, tab) for driving full-screen terminal UIs.
  • Dictate and attach. Use voice dictation to compose a message hands-free, or send a photo from your camera or library straight to your agent.
  • Open a project. Browse your Mac’s project folders and open a new gem from your phone.

On the same Wi-Fi, the app is free. When your phone and your Mac are on the same network, everything above works at no cost: watch your sessions and steer your agents (sending input, approving tools, merging a session). There’s nothing to buy inside the app.

Connecting from anywhere — reaching your Mac over the encrypted relay when you’re away from your home network — is part of Guild, the same membership that powers crystl’s pro features on the desktop.

Quests on your phone

If you’ve launched a quest, a party of agents working together, the app gives it a dedicated tab:

  • Follow the party chat. See the conversation between your heroes as it happens. Each hero speaks under its name and role, like Wizard (UI/UX).
  • Chime in. Send a message to the whole party from your phone; it lands on the quest’s shared channel just like a message you’d type on the Mac.
  • Hands off the heroes. Tapping an individual hero shows “this hero is in a quest” and routes you to the party chat, so a stray message can’t break the agents’ coordination by going to one agent instead of the group.

When no quest is running, the quest tab simply waits with an invitation to start one on your Mac.

Notifications

Turn on notifications and your phone alerts you the moment an agent needs you: a tool to approve, a question to answer, or a session that just finished. The alert carries only short labels (the project, session, and tool names) so you know what’s waiting; it never contains your messages, terminal output, or code. You can turn notifications off at any time in iOS Settings.

Requirements

  • An iPhone running iOS 16 or later.
  • A Mac running crystl, paired to the app.
  • Both devices on the same network, or remote access enabled, to connect from anywhere through the relay.

Privacy

The app collects no analytics and shows no ads. Your supervision data stays between your phone and your Mac; the only thing that leaves your devices is the push notification described above. Full details are in the privacy policy.