First-run wizard
The first time you launch kanade, a small wizard collects four pieces of
information. None of it leaves your machine; everything is written to
%APPDATA%\kanade\env.json and %APPDATA%\kanade\config.json.
What it asks
Section titled “What it asks”Local LLM URL (optional)
Section titled “Local LLM URL (optional)”The OpenAI-compatible base URL for your local LLM if you want Yume — the nightly
narration — to write paragraphs in Kanade’s voice. The default is
http://localhost:1234/v1, which is what LM Studio listens on out of the box.
If you don’t have a local LLM, leave it blank. The Claude Code workstation,
agent tools, MCP, skills, sessions, live telemetry, file tree, local chronicle,
and deterministic summaries still work. The local LLM only powers the
voice layer: /yume, Optimize prose, and per-session narrative paragraphs.
Examples:
- LM Studio (local):
http://localhost:1234/v1 - Ollama (local):
http://localhost:11434/v1 - Remote LM Studio on another machine:
http://192.168.1.50:1234/v1
Start at login
Section titled “Start at login”If checked, kanade adds itself to HKCU\Software\Microsoft\Windows\CurrentVersion\Run
so it boots into the system tray on login. Uncheck to launch only when you start it
yourself.
Open the desk on launch
Section titled “Open the desk on launch”If checked, the workstation window appears on startup. If unchecked, kanade boots silent into the tray — click the tray icon to reveal the window.
Account hint
Section titled “Account hint”A short label telling kanade what to call your first lane. It is account-agnostic on purpose — you can use a kanji, an emoji, your real name, or leave it blank. It does not authenticate anything; it is just a label.
After the wizard, the desk itself starts with zero connected accounts. Use
Scan for installed Claude logins if Claude Code is already signed in on this
machine, or choose Add a lane manually to configure a Claude, Codex,
DeepSeek, Gemini, or other provider lane yourself. Optional preset JSON bundles
live under examples/accounts; they are examples to review and import, not
credentials bundled with Kanade.
Re-running the wizard
Section titled “Re-running the wizard”The wizard only runs once. If you want to change a setting later, open the Settings entry from the system tray — same form, different invocation.
You can also edit %APPDATA%\kanade\env.json directly, but the tray Settings UI
validates the values and reloads the daemon for you.