Troubleshooting

Each of these is a real state the product can be in, with the reason it happens and the actual next step.

“Waiting for icloser on your machine”

What it means. The task is queued and nothing has claimed it.

Why. The executor is not running, or it is running in a different directory and therefore serving a different workspace.

Do this. On the machine that holds the code, check the agent is up. Start it from the directory you meant: icloser run. The first line it prints names the workspace it joined — check that it is the one you are sending to.

No runtime available

What it means. No CLI agent on that machine can take this task right now.

Why. Either none is installed, or the ones installed are out of quota, not signed in, or already failed on this task.

Do this. The card lists every agent and the reason each was skipped, with what has to change. Quota problems clear themselves at the time shown. “Not signed in” needs you to sign in to that agent's own CLI. “Not installed” needs an install.

Permission denied during a run

What it means. The agent refused a command mid-task.

Why. Two different causes: the tier was never granted — that refusal is KernelHub checking your grants; or the tier was granted and the runtime itself refused — its own permission settings are not a second authorisation system, and that refusal is not a KernelHub decision.

Do this. If a card appears, the tier is missing — approve it and the same task continues. If no card appears, the runtime refused something it was authorised for; if another runtime on the machine can take the task, the same task goes back to the queue and another one carries on, without asking you to approve again.

“It cannot hold the delete boundary”

What it means. The task would delete or move data, and the agent taking it cannot express a deny list.

Why. Not every CLI agent has that switch — see Runtimes.

Do this. Release that single run from the card — that is the exit for this boundary, not switching to an agent that "supports delete". Which agents hold which tier on your machine is on the home page table. Nothing has been deleted at the point the card appears.

The phone stopped updating

What it means. The task on the phone is frozen: either the phone cannot reach the gateway, or the gateway has nothing new — the Executor on that machine is not reporting.

Why. In this release the phone does not connect to the machine directly; the phone and the Executor each connect to the hosted gateway (kernelhub.icloser.xyz). The usual causes: the phone has no internet, or its network blocks that host; the machine is asleep or offline, or the Executor is not running.

Do this. On iOS, pull to refresh; on Android, leave the task page and open it again. Then run icloser doctor on that machine: it prints the gateway it uses first, then checks one by one whether the gateway is reachable and the token is valid. The two devices do not need to be on the same network, and changing Wi-Fi does not require pairing again.

A task says done but nothing changed

What it means. It finished without writing files.

Why. Usually it asked a question, or stopped at a boundary, or judged that no change was needed.

Do this. Read the timeline — the reason is in it. Use Revise to continue the same task rather than re-sending.

The change list is full of build files

What it means. The task ran a build, and build output counts as files it produced.

Do this. Your source edit is ordered first in the list. To keep a task's diff small, ask for the edit and the build as separate tasks.