Reference
Settings
In short
Settings holds the few things worth choosing in Wanigan, one section at a time, beside a list of every section. Each project has settings of its own too, in the menu under its name.
On this page
Open Settings
Most of Wanigan needs no choosing, so its settings are few. Open them with On a Mac, ⌘,; on Windows and Linux, Ctrl+,, the rail’s Settings, Wanigan 2 › Settings…, or Go › Settings; Go › Accounts opens Accounts directly.
| Group | Sections |
|---|---|
| Wanigan | Appearance, General, Live view, Voice, Updates |
| Agents | Accounts, Skills, MCP servers, Local models |
| Connected | Phone, Jev |
In the list, ↑ and ↓ move between sections, and Home and End go to its ends. Every section is in the palette too (On a Mac, ⌘K; on Windows and Linux, Ctrl+K): type its name, or “Live view settings” and “Voice input settings”.

Appearance
| Control | What it does | Kept |
|---|---|---|
| Theme | Match the system, Light or Dark. | This window’s storage on this computer (wanigan.theme). |
| Offer a view’s tour the first time you open it | Off, no tour starts by itself, the welcome tour included; each is still a click away. | This window’s storage (wanigan.tours). |
| Play the welcome tour, Offer every tour again | Plays the welcome tour now, or makes every tour offer itself again on your next visit. | The same. |
More on tours in Tours and How this works.
General
| Control | What it does |
|---|---|
| Keep this computer awake while sessions run | On by default. The display can still sleep, and only while Wanigan is open: quitting leaves sessions running and lets the computer sleep. The line under it says what it is doing now, such as “Holding this computer awake now, for 2 live sessions.” |
| Notifications | On (permission requests, failures, reviews, questions and finished turns), Only permission and failures, or Off, where Needs you and the Dock icon still count everything. |
Both are kept by the app, not the core, in electron/settings.json in Wanigan’s data folder. How notifications arrive is on The board.

Live view
| Control | What it does | Starts |
|---|---|---|
| Show each project’s local site inside Wanigan | The live view itself: a Live tab on the project and beside a session’s terminal. It opens the site you already run; nothing is installed or started. | Off |
| Drupal sites, WordPress sites, Other sites and JS apps | Each kind of site on or off, with that platform’s own integration. They wait until the live view is on. | On |
| Follow the agents’ edits | Reload as agents change files, and outline what each file made. Off, an edit only says what changed, and you reload. | On |
| Keep before and after screenshots on cards | A full-page picture of the card’s page as its session begins, and after each turn that changes files, kept in Wanigan’s data folder. | Off |
Folded under them, Hosted environments says how a site’s Dev, Test and Live are opened: read-only, and only when you do. These are kept in electron/settings.json, like General. Turning the view on is in Turning it on.

Voice
Voice input turns speech into text on this computer; the audio never leaves it. This section picks the speech model and shows what your operating system says of the microphone.
| Control | What it does |
|---|---|
| Model | Fast (Whisper base, 80 MB, about a second a sentence) or Accurate (Whisper small, 252 MB, about three seconds a sentence, better with noise, accents and languages other than English). Fast to begin with. |
| Download, Carry on, Remove | Each model is downloaded only when you click, from Hugging Face at a pinned commit, each file checked against its SHA-256. A stopped download carries on where it stopped; Remove deletes it. |
| Language | Detect it, or one of 28 languages. Naming yours makes the fast model more accurate: in testing, Portuguese went from 67% of characters wrong to 19%. |
| Narrate recordings | While the live view records, what you say goes into the step log at the moment you say it. Off by default; without it, the mic beside Record narrates one recording. |
| The keys | On a Mac, ⌘⇧M; on Windows and Linux, Ctrl+Shift+M starts or stops listening in the box you are typing in; hold On a Mac, ⌘⇧H; on Windows and Linux, Ctrl+Shift+H to listen until you let go. |
| Microphone | What the system says: allowed, not asked yet, refused (with Open its settings), or blocked by this computer’s settings or policy. |
The choices are kept in voice/settings.json, and the models in voice/models/, in Wanigan’s data folder. More in Speaking instead of typing.

Updates
| Control | What it does |
|---|---|
| Check now | Asks GitHub whether a newer version is out. The line under the version says what it found: not checked yet, up to date, or why it could not check. |
| Download, Release notes | Shown when a newer version is out, with how to install it. |
| Check for a new version once a day | Off until you say yes. It reads GitHub’s public list of releases; no project, conversation or usage data goes with it. |
The daily choice is kept in electron/settings.json, and the last check in electron/updates.json. Installing stays a download you choose: see Updating.

Accounts
Every Claude Code and Codex account Wanigan found, each with who it is signed in as according to the agent, its limits and the projects that use it. Add account beside an agent makes and signs in a new one; Sign in, Make default, and More › Rename or Remove from Wanigan act on one row; Check again asks every agent once more; How this works draws the rules.
Each sign-in stays in the account’s own folder, where the agent keeps it; Wanigan never holds, reads or copies a password or a token. Its database keeps the list of accounts and each project’s choice. Everything else is in Accounts and models.
Skills
Every skill your agents can see, grouped by where it lives: personal, in a project, from a plugin, or synced from claude.ai. Reading is free; nothing is copied or removed until you click, after seeing what changes.
| Control | What it does |
|---|---|
| Agent, the search | Shows one agent’s skills, or those matching words in a name or description. |
| A skill | Its SKILL.md opens beside the list, with who sees it, how to call it and where its folder is. |
| Copy to a project…, Copy to my skills… | Shows every file it would write, and where, first. A skill already there is replaced only if you tick to replace it. A copy into a project is a change git sees; nothing is committed. |
| Remove… | Moves the skill’s folder to Wanigan’s trash (trash/skills/ in its data folder), where you can take it back; a link is removed and what it points to stays. Sessions that start after stop seeing it. |
Skills stay in the agents’ own folders; Wanigan keeps none of its own. Built-in skills and Codex’s plugin skills are not listed.

MCP servers
Every MCP server each account and open project has, read from the agents’ own files, and a store of twelve well-known ones. A change runs the agent’s own command, as the account you chose, only after you have seen it exactly.
| Control | What it does |
|---|---|
| Installed, Store | What is set up now, or the store. On Installed, Agent shows one agent’s servers. |
| Check connections | Runs claude mcp list as that Claude Code account, which starts each server to see whether it answers. Only when you click. |
| Remove… | Shows the exact command first, then runs it with no shell. |
| Add… in the store | Choose the account and where it is kept: User (every project), Local (one folder) or Project (in the repository, for everyone who clones it). A server that needs a key or a browser sign-in is finished in a terminal, with the command typed in and not run, or copied for your own. |
Servers are kept in each agent’s own settings. Values that look like keys or tokens are never shown, and Wanigan never asks for or keeps a key. Gemini CLI’s servers are copied into Wanigan’s Gemini home only when they hold nothing that could be a credential, and this section says so.

Local models
Models that run on this computer. Under LM Studio, Its server says whether it runs, with Start its server. Models Wanigan knows lists each with the agent it runs with and whether that pairing is proven: Get shows the size and asks first, Stop stops a download, and Carry on resumes one. Other models on this computer lists what LM Studio, Ollama or NVIDIA PAIR has besides.
Models are kept in LM Studio’s own folder, ~/.lmstudio/models, not in Wanigan’s; Wanigan keeps 10 GB of your disk free, and a model is removed in LM Studio itself. The whole story is in Models on this computer.
Phone
| Control | What it does |
|---|---|
| Tailscale | Says whether Tailscale is installed, connected and has HTTPS certificates on for your network, with what to do and Check again. |
| Turn on phone access | Shows the one tailscale serve command it runs, then runs it. Turn off removes only Wanigan’s address from Tailscale; paired phones stay paired. |
| Show a pairing code | A code and a QR code, which work once, for ten minutes; New code makes another. |
| A paired phone | Can act on lets it answer what needs you, start and type into sessions and move cards; off, it can only read. Forget cuts it off at once. Send a test notification checks the phones with notifications on. |
Phone access and each paired phone are kept in the core’s database, a phone’s key only as a hash; a new phone can act until you turn that off. This Mac’s push key is in phone-push.json, readable only by you. Setting it up is on The board, and what a phone may reach in Security and privacy.

Jev
Under Connection, paste a TypeSafe API key and click Save and test, or export TYPESAFE_API_KEY in your shell; Test the connection and Forget the key follow. So far counts calls, failures and the estimated cost, and In each project sets each project to Off, Reads or Reads and accepts. Once a key is set, Jev’s health shows beside the title.
A saved key is jev.key in Wanigan’s data folder, readable only by you, and a key in your shell wins over it. Each project’s mode is in the core’s database, and starts on Reads. All of it is in Jev.
Project settings
What one project needs differently, such as a work account or its own branches, is in its own settings. Click the project’s name in the project bar and choose Project settings….
| Control | What it does |
|---|---|
| Name, Key | The project’s name, and its key of up to six characters, which prefixes its card keys; changing it renames every card. The folder is shown under them. |
| Card sessions work on their own branch | Each card gets its own git worktree, so agents on different cards never share files; you merge each after review. Only for a git repository. |
| Setup command | Up to 500 characters, such as npm install, run in each new card worktree as a shell session beside the agent. Kept in Wanigan, never in the repository. |
| Accounts | The Claude Code and Codex account the project’s new sessions use, or Your default. |
| Local model › Start new sessions on | A model on this computer for new sessions here, or The agent’s own model. Shown once a local model is on this computer. |
| Close project | Takes the project off the rail, keeping its cards, sessions and history; opening its folder again brings it all back. It waits until no session runs. |
The switch and the pickers apply at once; the name, key and setup command wait for Save. All of it is kept in the core’s database.

Elsewhere for a project
- Jev’s mode is on the Jev strip above the board, and in Settings › Jev.
- Pause is in the project bar (Pause and Decisions).
- The live view’s site, its helper and its hosted environments are under Site settings… in the live view’s site menu (Turning it on).
- Before and after screenshots are one switch for every project, in Settings › Live view.
- Decisions, the rules told to every session, are a view of their own (G then D).
In depth
Where each setting is kept
| Setting | Kept in |
|---|---|
| Theme, tours | This window’s storage on this computer |
| General, Live view, the daily update check | electron/settings.json; the last check in electron/updates.json |
| Voice | voice/settings.json, and the models in voice/models/ |
| Accounts list, project settings, Jev’s modes, phones, saved views, each project’s live site | The core’s database, wanigan.db |
| Jev’s key, this Mac’s push key | jev.key and phone-push.json, readable only by you |
| Skills, MCP servers, sign-ins, local models | Where the agents and LM Studio keep them; Wanigan keeps none |
- A settings file that is missing or holds something of the wrong type counts as the defaults, never as an error, and the window can only send known settings of the right type.
- A paired phone never reaches Settings, accounts, sign-ins, skills, MCP servers, Jev’s key or pairing.
- The demo keeps its own settings in its own folder,
Wanigan 2 Demo, so nothing you change there touches yours.
