KernelHub Frequently asked questions
If an answer here disagrees with what the product shows you, trust the product and tell us.
What must be on my computer before I install?
Node.js LTS, which ships npm — this is required. Check that node -v and npm -v both print a version first. Runtimes are installed through npm, and the KernelHub installer does not install Node for you. Step by step: Windows from zero · Mac from zero · Linux from zero.
Does my code get uploaded?
No. The agent executes on your machine. What crosses the network is your task text, progress, the diffs you asked to see, and your approvals.
Do I need an API key from you?
No. KernelHub does not include a model and never calls one. It drives a CLI agent you installed and signed in to yourself; billing and terms for that agent are between you and its provider.
Which coding agents work?
Fourteen adapters, including Claude Code, Codex, Antigravity (agy) and Qwen Code. Your grants are checked the same way whichever one runs; Runtimes shows what each one can additionally hold on its own.
Can it delete files?
Only if you release that specific run from a card. The delete / migrate tier cannot be granted from a phone, and approving a release grants no permission tier.
What happens if I approve something by mistake?
A task-scoped approval covers that one task in that one workspace and expires when the task ends. Cancel the task and the approval goes with it.
Can two people share a workspace?
Yes. Permissions are recorded per device, so each person's machine has its own tiers. Approvals are visible to whoever is looking at that workspace.
Does it work offline?
The agent runs locally, but the control plane is what carries tasks between your phone and your machine. Without a network the two cannot talk.
Why did it pick a different agent than I expected?
Routing skips agents that are not installed or will not start, are cooling down after a quota error, or already failed on this task; a task that would delete data prefers an agent that can hold a deny list. The card says which was chosen and why each other was skipped.
Can I stop a task mid-run?
Yes. Cancel is honoured while it is running.
Where is data stored on my machine?
In three directories: ~/.kernelhub (configuration and the task ledger), ~/.kernelhub-gate (identity credentials) and ~/.kernelhub-protected (the protected root, if present). Deleting all three removes it.
Is there an Android client?
Yes — the download page carries an Android APK, signed with a debug certificate rather than a Play release key. What v1.0.2 ships: the executor for macOS, Linux and Windows; KernelHub Desktop for macOS, Windows x64 (MSI) and Windows ARM64 (portable ZIP) — the executor on Windows has been verified on real machines, the two Windows Desktop packages have not; the iPhone client, which is available on the App Store; and the Android APK. Anything not on the download page is not something we will claim here.