Something is broken
Open an issue on GitHub Issues with three things: what you did, what you expected, and what happened instead. A screenshot of the exact moment helps more than a long description. If the issue involves anything you would not post publicly, email support@bloks.dev instead.
Security
Found a vulnerability? Please do not open a public issue. Email security@bloks.dev and it will be read the same day. The repository’s security policy has scope and details.
Common fixes
The app says Bloks is not reachable
The interface talks to a small server that runs with the app. Quit Bloks fully (Cmd‑Q) and reopen it. If you run from source, pnpm dev:server starts it by hand. Nothing is lost either way; conversations live on disk.
My agent says its engine is not installed
The agent is pointed at a CLI engine that this Mac does not have. Either install it (for example npm i -g @anthropic-ai/claude-code) or open the agent’s settings and pick a different engine. Pasted-key engines need no install.
My phone cannot find my Mac
Pairing needs both devices on the same network, and pairing turned on in the Mac app under Settings, Devices. Scan the QR code the Mac shows, or type the six digit code. If it still fails, the network may isolate devices from each other; hotel and office Wi‑Fi often does.
An agent is stuck working
Every lane has an interrupt. Open the conversation and stop the turn from the task strip; the agent halts cleanly and the transcript keeps what happened. If the whole app misbehaves, quitting and reopening never loses data.
Where exactly is my data?
One folder: ~/.bloks. Agents, transcripts, memory, keys, settings. Back it up with everything else you back up. Delete it and Bloks starts from zero.
Quick answers
Is the desktop app really free?
Yes. Your own keys, unlimited agents, no expiry. It is not a trial. Paid tiers add hosting we run, never features held back from the app you have.
Which engines work?
Claude Code, Codex, Gemini CLI, OpenCode, Grok CLI and Antigravity as installed CLIs; Gemini, Grok, Kimi, Llama, DeepSeek, Mistral and Groq by pasted key; OpenRouter by browser sign-in; Ollama for local models. The docs cover each one.
When is mobile coming?
The iPhone app pairs with your Mac on your network today, from source. The App Store version and Bloks Cloud, which works away from your network, are next. The waitlist on the front page hears first.
Everything else
support@bloks.dev reaches a person, not a queue.