Troubleshooting

The most common problems come from the three moving parts: the daemon, Clerk, and whatever model or CLI you pointed Hoook at.

The app is stuck on "Starting daemon…"

In a development build, check the daemon directly:

hoook ping    # expect "ok"

If that fails, something else may be holding port 47821, or the daemon may have failed to compile. Check the pnpm dev output for Rust errors.

If you built the app in release mode, this hang is expected and is not your fault. The daemon is only spawned automatically in development builds and is not yet bundled as a sidecar, so a packaged build has no daemon to talk to. Run from source with pnpm dev.

I cannot get past the sign-in screen

Sign-in is mandatory and needs valid Clerk keys in apps/desktop/.env. If you are signed in but land on onboarding instead of the app, your account is not in a Clerk organization. A workspace is an organization, so you need one before anything else works.

Claude or GPT models are missing from the picker

The provider lists are gated on the API key being present in the daemon's environment when it starts. Export the key, then restart so the daemon inherits it:

export ANTHROPIC_API_KEY=sk-ant-...
pnpm dev

There is no settings field for keys, so a key stored anywhere else has no effect.

My chat fails mentioning Ollama, but I picked Claude

Provider routing is by model-name prefix, and anything unrecognised falls through to Ollama. A misspelled model name silently becomes an Ollama request. Check the exact name against Chat and models.

Ollama models are not listed

Hoook asks Ollama for its models at 127.0.0.1:11434. Confirm it is up and has at least one model pulled:

ollama list

An agent tab opens and immediately fails

The CLI is not on your PATH. Hoook runs what you have installed and does not bundle agents. Verify in your own terminal:

which claude    # or codex, gemini, cursor-agent

Settings lists which tools Hoook can detect. Note it searches the usual Homebrew paths, so a binary installed somewhere unusual may not be found even if your shell finds it.

My skill installed but nothing happens

Expected. Skills install but do not execute yet; there is no runtime. See Skills.

A button does nothing

Also possibly expected. Connectors, gateways, schedules, and the marketplace are placeholder interfaces with no implementation behind them. The overview lists what is real.

Still stuck

Get in touch and we will help.