Using Jade
What Jade is and how to use it, from the first chat to tasks that keep running while the app is closed.
On this page
Jade in one paragraph. Jade is an AI app for iPhone, iPad and Mac. You can chat with a model, or give it a task: it makes a plan, uses the web and your apps to do the steps, asks before anything risky, and writes up the result. It works with the model you choose.
Get started
- Install it. The beta is on TestFlight for iPhone and iPad.
- Take the tour. The first launch walks through the basics. You can run it again any time from the bottom of Settings.
- Connect a model. Jade needs a model to talk to. Pick one of these:
- Your own key for OpenAI, Anthropic, OpenRouter, Ollama, or any server that speaks the OpenAI or Anthropic format. Keys are kept in the Keychain.
- A model on the device, downloaded in Settings → Models → On-device models. It works offline.
- Jade AI, with a Jade Pro or Jade Max plan. No key needed.
- Say something. Open Chats, tap New chat and type. To hand off a job, describe the goal in plain words, like “find three flights to Lisbon next month and compare them”.
If the Models row in Settings shows Connect, no model is set up yet. Nothing else works until one is.
The screens
- Chats
- Your conversations. Each chat can use a different model. New chats start with your default model. Pin, search, rename and delete from the list. A switch in the list keeps code chats apart from the others.
- Routines
- Prompts that run on a schedule, like every weekday at 8. Each run is a task you can open.
- Cloud
- Jade Cloud: tasks, routines and webhooks that keep running while the app is closed. It is grayed out until there is a plan (or a Jade Cloud of your own) and then leads to the plans.
- Memory
- What Jade remembers about you. You can review, edit, pin and delete it.
- Apps
- The services and apps Jade can use: your calendar and reminders, MCP servers, and apps from the marketplace.
- Usage
- Tokens, tool calls and, with a plan, task time used.
- Settings
- Everything else. See Settings.
On a wide screen these sit in a sidebar. On a phone they are a bar at the bottom or top. Settings → Layout chooses which screens show and where, or turns the bar off.
Chatting
- Pick the model from the chat’s top bar. If a model fails (an outage, a rate limit, a rejected key), Jade tries the next one down your list unless you turned that off under Settings → Models → Fallback.
- Edit, rewind and fork. Edit an earlier message and continue from there, rewind to a point, or fork a copy of the chat.
- Attach photos and files. A very long paste becomes an attached text file (a setting).
- Talk. Start a voice call and hear replies read aloud. Voices are chosen under Settings → Personality & voice → Voice.
- Cards. Jade can answer with a chart, a map, a weather card, a list of events and other cards, and can save one for requests you repeat.
- Temporary chats are not kept.
- Tool switches at the top of a chat turn the web, the terminal and memory on or off for that chat (Settings → Look & layout).
Giving Jade a task
A task is a goal that takes several steps. Describe it in a chat and Jade hands it to its agent.
- Plan. Jade writes a plan. You can edit it while the task runs: add a step, reword one that has not started, or take one off.
- Steps. It works through the steps with tools: web search, the browser, files, code, your apps. If a step fails it tries another way, and says plainly what it could not do.
- Approvals. Anything risky stops and asks. See Approvals.
- Result. It writes up the answer with sources and keeps the files it made.
You can talk to a task while it runs. A running step reads your note at its next model call.
How much it asks
- Ask first
- Checks with you before anything that changes something or reads your private data.
- Balanced
- Runs what you have allowed before and asks for the rest.
- Hands-off
- Handles everyday actions by itself. Still asks before anything risky, like spending money or sending things.
The level is set per task and its default is under Settings → Tasks.
Where it runs
By default a task runs on the iPhone, while Jade is open and for the short time iOS allows after you leave. iOS pauses background work soon after that. Jade Cloud is a server that carries on instead. With it on, a task moves to the server when you close Jade and keeps going with the phone locked or off. Progress shows as a Live Activity on the Lock Screen.
Approvals
Jade asks before it does anything that could cost you something. In a chat the question appears in the conversation. In a task it also reaches you as a notification with a Deny button on it.
- Allow once
- Do it this time.
- Always allow
- Do it without asking again. You can see and undo these under Settings → Privacy & safety → Approvals.
- Deny
- Don’t. The task works around it or says what is missing.
- Spending money, sending messages, deleting things, running code, and clicking or typing on websites ask first.
- Content that came from outside (web pages, an MCP tool’s result, a webhook) is treated as data, not as instructions. A task that has read outside content asks again before a risky tool, even one you always allow.
- Changing Jade’s own settings through the assistant always asks, lists exactly what changes, and can be undone under Changes Jade made.
Apps and connections
The Apps screen is where Jade’s reach is set up.
- Your device. Calendar, Reminders, Contacts, Notes (through two shortcuts you make), Shortcuts and other Apple apps. Each has a switch under Apps → On this iPhone, and iOS asks its own permission first. Mail and Messages can only open a draft that you send yourself.
- Services. Add GitHub, Linear and others from the catalog, from a link, or from a file. A service signs in with a token you paste or by signing in on the service’s own page. Jade never sees your password.
- Script apps. Small apps made of scripts that run on your device. Each asks for the access it needs, and you answer Ask first, Allowed or Blocked for each.
- MCP servers. Any remote MCP server can be added under Settings → Apps & tools.
Developers can publish their own: see the marketplace API.
Memory
Jade can remember things between chats. By default it proposes memories and nothing is used until you accept it. Under Memory you can accept, edit, pin (always included) or delete each one. Settings let it remember automatically, and let you choose whether related memories are sent along with a task that runs in Jade Cloud. It also keeps short notes about websites it has used.
The browser and passwords
Jade can open pages, read them, follow links and fill forms in its own browser.
- Passwords. Saved sign-ins live in the device’s Keychain and need Face ID or the passcode to use. The model never sees a password: it writes a stand-in, and the real value is typed only on the site the sign-in belongs to.
- Sign-in needed. If a task needs you to sign in to a site, it stops and says so. Sign in on the phone and tap Try again.
- CAPTCHAs. Jade stops and hands over to you. It does not solve them.
Jade Cloud
Jade Cloud runs your tasks on a server. It needs a plan, or a runner of your own.
- Jade Pro
- $4.99 a month or $49.99 a year, with a 1-week trial. Tasks, routines and webhooks in Jade Cloud, 5 hours of task time a week and 100 new tasks a day, Jade AI (Auto, Fast, Expert) and pictures.
- Jade Max
- $12.99 a month or $129.99 a year, with a 1-week trial. Three times the task time, tasks and pictures, plus Jade AI Ultra.
- Your own
- Run the Jade Cloud server yourself with Docker, with no plan limits. See For developers.
Prices are from the App Store and vary by country. A server of your own pairs with a one-time code (“Have a pairing code?” in the app).
- Not on the server. Calendar, reminders, contacts, on-device models and the in-app file workspace stay on the phone. A task on the server can’t use them.
- What it sees. Only what a task needs: the goal, the settings you sent, and what you chose to share. Notifications say only that something happened; Jade fetches the details afterwards.
- Sign-ins. A saved password reaches the server only if you turn on “Jade Cloud tasks can use it” for that sign-in, after Face ID.
If something is wrong
- Nothing happens when I send
- No model is connected, or its key was rejected. Settings → Models. “Test connection” on the provider tells which.
- A task stopped and says it needs me
- It is waiting for an approval or for you to sign in to a site. Open it and answer, then tap Try again if it offers it.
- Cloud is grayed out
- There is no plan yet. Tap it to see the plans, or pair with a code if you run your own.
- A task stopped when I left the app
- iOS paused it. Turn on “Move tasks and routines to Jade Cloud when Jade closes” in Settings → Tasks, or keep Jade open.
- I want my data out
- Settings → Privacy & safety → Import & export. API keys are never in an export.
- I want it gone
- Settings → Tasks → Devices lists paired devices and unpairs them. An account on a runner can be deleted from the server.