DocsUsing Jade
Troubleshooting
Common problems and what to do about them.
Models and chats
- “Connect” shows where the model should be
- No model is set up. Settings → Models: add a key, download an on-device model, or pick Jade AI with a plan.
- The model says it can’t do something it should
- The model may not support tools. Settings → Models shows what each model can do. Pick one with tool use for tasks.
- 401 or “invalid key”
- The key was rejected: it is wrong, expired or has no credit. Open the provider and use “Test connection”. A key never has to be pasted twice: fix it in one place.
- 429 or “rate limit”
- The provider is busy or the plan’s limit was reached. With fallback on (Settings → Models → Fallback), Jade tries the next model by itself.
- A local server (Ollama, LM Studio) doesn’t answer
- The phone must reach it: same Wi-Fi, the server listening on the network (not only 127.0.0.1), and its address in the provider with the right port.
- Replies cut off
- The model reached its output limit or the connection dropped. Ask it to continue. Long outputs on small models do this.
Tasks
- A task says it is waiting
- It needs an approval or a sign-in. Open it: the question is at the bottom. Notifications carry Allow and Deny.
- A task stopped when I closed the app
- iOS suspends background work soon after leaving an app. Turn on “Move tasks and routines to Jade Cloud when Jade closes” (Settings → Tasks), or keep the app open.
- It keeps asking the same thing
- Choose Always allow for that tool. The list of these is under Settings → Privacy & safety → Approvals.
- “Subscription ended” or a 402 error
- The plan lapsed or its weekly allowance is used up. The answer says which, and when it resets. Renew or wait.
- “Too many tasks”
- The plan’s daily limit of new tasks was reached. The message says when more can start.
- The task failed on a step
- Open the step: the error is shown in plain words. Retry runs it again; editing the plan lets one step be skipped or reworded.
- A website needs a CAPTCHA
- Jade doesn’t solve them. It stops and hands over: complete it on the phone and tap Try again.
Jade Cloud and pairing
- Pairing says the code is wrong
- A code works once and for 15 minutes. Make a new one with
jade pair. Check for similar letters, and that the code was made on the server the app is pointed at. - “Too many pairing attempts”
- Ten tries in ten minutes from one address. Wait a few minutes.
- “Isn’t paired any more”
- The device was signed out (
jade unpair, or Settings → Tasks → Devices). Pair it again with a new code. - “This account no longer exists”
- The account was deleted on the server.
- 423: locked
- The account is locked and this device didn’t send the key. Open Jade on a device that has it. Held work resumes once one unlocks.
- Access ended
- An account paired with a limited-access code stops working when its time is up. The server’s owner can extend it (
jade set-plan). - No notifications
- Push needs the server to have an APNs key. A self-hosted one without it can still run tasks, but the app has to be opened to see them.
Running a server
- How is it doing?
jade statusshows the services.jade logsfollows them.GET /healthzanswers{"ok": true}when the runner is up.- The master key
- Never lose it: without it the data can’t be opened.
jade master-keyprints it, andjade check-keytells whether it opens the data. - The browser or code workspace is missing
jade codeandjade imagescheck them. The browser needs Chromium in its container; code workspaces need the code container to be up.- Updating
jade updaterebuilds from the code on the server. To ship new code, run the upload script again.- The website isn’t showing
- The server serves it at its own address unless
JADE_SITE=0. Pages are cached in memory: restart the runner after a change.
More on running one: Self-hosting.
Privacy questions
- Does Jade read my chats?
- No. Chats stay on the device (and in the user’s iCloud if sync is on). Jade Cloud holds only what its tasks need, sealed. See Privacy and security.
- Can the model see my passwords?
- No. It writes a stand-in; the real value is typed only on the matching site.
- How do I delete everything?
- Export first if wanted, then delete the account (Settings, or
DELETE /v1/me). Chats on the phone are deleted from the app.