All docs pages: Reference

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.

The list beside every section, in its order.
GroupSections
WaniganAppearance, General, Live view, Voice, Updates
AgentsAccounts, Skills, MCP servers, Local models
ConnectedPhone, 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”.

Settings in the demo, open on Appearance: the list of sections on the left under Wanigan, Agents and Connected, and Appearance’s Look and Guided tours groups on the right. Current beta · demo
The Settings view. A column on the left lists the sections in three groups, with Appearance highlighted. On the right, a group headed Look holds the Theme switch, and a group headed Guided tours holds a switch and two buttons.

Appearance

ControlWhat it doesKept
ThemeMatch the system, Light or Dark.This window’s storage on this computer (wanigan.theme).
Offer a view’s tour the first time you open itOff, 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 againPlays 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

ControlWhat it does
Keep this computer awake while sessions runOn 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.”
NotificationsOn (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.

Settings › General in the demo: Keep this computer awake while sessions run switched on, the line under it saying Nothing is live, so this computer may sleep, and Notifications set to On. Current beta · demo
The General section with two groups. Under While sessions run, a switch that is on, with a line saying nothing is live so the computer may sleep. Under Notifications, a three-way switch reading On, Only permission and failures, and Off, with On chosen.

Live view

ControlWhat it doesStarts
Show each project’s local site inside WaniganThe 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 appsEach kind of site on or off, with that platform’s own integration. They wait until the live view is on.On
Follow the agents’ editsReload 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 cardsA 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.

Settings › Live view in the demo: Show each project’s local site inside Wanigan, Show it for with Drupal sites, WordPress sites and Other sites and JS apps, While agents work with Follow the agents’ edits and Keep before and after screenshots on cards, and Hosted environments folded. Current beta · demo
The Live view section of Settings: a switch to show each project’s local site inside Wanigan, then Show it for with three switches, While agents work with two, and a folded Hosted environments group at the foot.

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.

ControlWhat it does
ModelFast (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, RemoveEach 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.
LanguageDetect 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 recordingsWhile 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 keysOn 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.
MicrophoneWhat 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.

Settings › Voice in the demo: Model set to Fast, the Fast and Accurate models each with its size, source and Download button, then Language on Detect it, Narrate recordings off, the two keys, and Microphone. Current beta · demo
The Voice section. A two-way switch reads Fast and Accurate. Below it two rows, one per model, each with its name, size, a line on what it is good for, where it comes from, and a Download button. Then a language picker, a switch for narrating recordings, the two voice keys as key caps, and a line about the microphone.

Updates

ControlWhat it does
Check nowAsks 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 notesShown when a newer version is out, with how to install it.
Check for a new version once a dayOff 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.

Settings › Updates in the demo: Updates are not checked here, because the demo never asks the network. Current beta · demo
The Updates section showing only a calm notice with an icon: updates are not checked here, and the demo never asks the network, so it never looks for a new version.

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.

ControlWhat it does
Agent, the searchShows one agent’s skills, or those matching words in a name or description.
A skillIts 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.

Settings › Skills in the demo: the skills grouped by where they live, the Agent filter and search in the bar, and one skill’s SKILL.md open beside the list with Copy to a project…, Copy to my skills… and Remove…. Current beta · demo
The Skills section in two columns. On the left, groups of skills, each group naming an agent and a folder. On the right, the chosen skill’s instructions as formatted text under its name, with three buttons above them.

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.

ControlWhat it does
Installed, StoreWhat is set up now, or the store. On Installed, Agent shows one agent’s servers.
Check connectionsRuns 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 storeChoose 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.

Settings › MCP servers in the demo on Installed: each account’s and project’s servers under its name and file, Check connections beside a Claude Code group, and the Agent filter and the Installed and Store tabs in the bar. Current beta · demo
The MCP servers section. In the bar, a four-way Agent switch and two tabs, Installed with a count and Store. Below, groups headed by an account or project with the file each is read from, each listing servers with a status dot and a Remove button; one group has a Check connections button.

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

ControlWhat it does
TailscaleSays whether Tailscale is installed, connected and has HTTPS certificates on for your network, with what to do and Check again.
Turn on phone accessShows 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 codeA code and a QR code, which work once, for ten minutes; New code makes another.
A paired phoneCan 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.

Settings › Phone in the demo: Tailscale connected as your-mac.example.ts.net, and Phone access is off, with the one command it would run and Turn on phone access. Current beta · demo
The Phone section with one group, Reaching this computer. Its first row has a green dot and says Tailscale is connected. Its second says phone access is off, quotes the tailscale serve command it would run and the address it would make, and has a blue Turn on phone access button.

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….

ControlWhat it does
Name, KeyThe 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 branchEach 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 commandUp 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.
AccountsThe Claude Code and Codex account the project’s new sessions use, or Your default.
Local model › Start new sessions onA model on this computer for new sessions here, or The agent’s own model. Shown once a local model is on this computer.
Close projectTakes 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.

Northstar Storefront settings in the demo: Name and Key NS with the folder under them, Branches with Card sessions work on their own branch and Setup command, Accounts with Claude Code and Codex, and Local model, with Cancel and Save. Current beta · demo
A dialog titled Northstar Storefront settings: name and key fields, the project’s folder, a Branches switch with its note, a Setup command field, an Accounts group with a Claude Code picker and a Codex picker, the start of a Local model group, and Cancel and Save at the foot.

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

Paths are inside Wanigan’s data folder, ~/Library/Application Support/Wanigan 2/, unless they say otherwise.
SettingKept in
Theme, toursThis window’s storage on this computer
General, Live view, the daily update checkelectron/settings.json; the last check in electron/updates.json
Voicevoice/settings.json, and the models in voice/models/
Accounts list, project settings, Jev’s modes, phones, saved views, each project’s live siteThe core’s database, wanigan.db
Jev’s key, this Mac’s push keyjev.key and phone-push.json, readable only by you
Skills, MCP servers, sign-ins, local modelsWhere 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.