DocsUsing Jade

Troubleshooting

Common problems and what to do about them.

On this page
Models and chatsTasksJade Cloud and pairingRunning a serverPrivacy questions

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 status shows the services. jade logs follows them. GET /healthz answers {"ok": true} when the runner is up.
The master key
Never lose it: without it the data can’t be opened. jade master-key prints it, and jade check-key tells whether it opens the data.
The browser or code workspace is missing
jade code and jade images check them. The browser needs Chromium in its container; code workspaces need the code container to be up.
Updating
jade update rebuilds 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.