All docs pages: Get started

Get started

Accounts and models

In short

Your agents sign in with their own accounts, and Wanigan asks each agent who it is signed in as; each project can use a different one, work or personal. If you prefer, Claude Code can run on a model that lives on your Mac, so prompts and code never leave it.

On this page

Your agents’ accounts

Work and personal, or one plan per client: an agent signed in once has no idea which project should use which. In Wanigan an account is a folder your agent keeps its sign-in in, and each project chooses its own.

Accounts live in Settings › Accounts (also in the palette and the Go menu). Each row says who the account is signed in as, according to the agent itself, with its plan, what its limits have left and which projects use it. Wanigan never holds, reads or copies a password or a token.

Settings › Accounts in the demo: Claude Code’s and Codex’s accounts, each row with who it is signed in as, its Session and Week meters, its folder and the projects that use it. Current beta · demo
The Accounts section of Settings with a Claude Code group and a Codex group. Each account row shows a green dot and who it is signed in as, two meters for the session and the week with how much is used and when each resets, its folder, and small project keys after Used by.
The row saysWhat it means
Who it is, and its planThe agent says this folder is signed in as that person.
Signed outThe agent says nobody is signed in here. Sign in fixes it.
Signed out, and a project uses itThe same, in amber, because that project’s next session needs it; Sign in turns amber too.
Could not tell whether this account is signed inThe agent gave no clear answer, and Wanigan does not guess.
Folder missingThe account’s folder is gone.
Claude Code is not installedThe CLI is not on your login shell’s path. The row gives the install command; then press Check again.
Same login as …Two folders signed in to one login. They share one set of limits.

Choose a project’s accounts

  1. Open the project’s settings

    In the project, click its name in the project bar and choose Project settings….

  2. Pick an account for each agent

    Under Accounts, choose a Claude Code and a Codex account. Your default follows whichever account is the default. The choice applies at once, to the project’s new sessions.

    Northstar Storefront settings: Name and Key, then the Accounts section with its Claude Code and Codex pickers. Current beta · demo
    A dialog titled Northstar Storefront settings with name and key fields, a Branches section, and an Accounts section saying new sessions here use these accounts, with one picker for Claude Code and one for Codex.
  3. Start a session

    New session (On a Mac, ⌘T; on Windows and Linux, Ctrl+T) starts on the project’s account, marked “this project’s”, and shows what that account has left. You can still pick another for this one session.

    New session in Northstar Storefront with Claude Code chosen: the Account picker showing the project’s account, and the line under it about its limits. Current beta · demo
    The New session dialog with Project, the Agent switch set to Claude Code, an Account picker reading Default, and under it a line saying its limits have not been read yet, then Model, Effort and Card.

Add an account

Your agents’ usual folders, ~/.claude and ~/.codex, are found by themselves, and so are other account folders in your home named like them. To add another:

  1. Add account

    In Settings › Accounts, click Add account beside Claude Code or Codex, give it a name you will recognise, such as “Work” or “Client: Northstar”, and choose Add and sign in.

  2. Sign in in the terminal

    Wanigan makes a new folder in your home for it and opens the agent there, in a terminal inside the dialog. Follow its prompts (in Claude Code you can type /login); your browser opens to finish signing in.

  3. Done

    Click Done, and Wanigan asks the agent again who it is signed in as.

Sign in on a signed-out row does the same for a folder you already have. Make default makes an account the one every project that has not chosen uses. A row’s More menu has Rename, and Remove from Wanigan, which stops offering the account and leaves its folder and its sign-in exactly as they were. Check again asks every agent who it is signed in as, and reads their limits again.

Usage at a glance

Each signed-in account shows its limits as the agent reports them: a Session and a Week meter, how much is used (or “used up”), when each resets, and how long ago it was read. New session shows the same for the account you pick, as what is left, so a session starts where there is room. There are no dollars anywhere: a plan is not billed per token.

What happens when an account runs out, and carrying a Claude Code conversation on under another account, is on Agents and the board.

Gemini CLI’s sign-in

Gemini CLI has one sign-in, kept where Gemini keeps it, so it has no rows in Accounts and every project uses it. Gemini takes hooks only from its own settings, so Wanigan keeps a Gemini home of its own in its data folder (GEMINI_CLI_HOME), and your ~/.gemini is never written. As each session starts, your chosen sign-in method, your trusted folders and the MCP servers that hold nothing that could be a credential are copied in, and your own skills are linked so Gemini reads them where they are.

  • Gemini’s first screen may ask you to sign in or to trust the folder, so send the first message in its terminal; the message box works from the second.
  • When Gemini reaches its usage limit it draws a dialog (keep trying, switch model, or stop). Wanigan shows the session as limited, and Needs you sends you to its terminal with Answer in terminal.
  • Your own Gemini extensions and global GEMINI.md are not loaded in Wanigan’s Gemini home.

Models on this computer

Some work should not leave your Mac, and some days a plan’s limit runs out. Claude Code can run on a model that lives on your Mac, through LM Studio: prompts and code go to it, not to a model provider, and no plan’s limits apply. It is optional. Without LM Studio, Wanigan works exactly as it does, and nothing is downloaded until you choose.

  1. Get LM Studio

    Install LM Studio and open it once; Wanigan finds it then. Settings › Local models shows whether it is installed and whether its server is running.

  2. Get a model

    Under Models Wanigan knows, Qwen3-Coder 30B runs with Claude Code. Get (17.2 GB) asks first, saying what LM Studio downloads and where (~/.lmstudio/models); Download 17.2 GB starts it. Progress shows as it goes, Stop stops it, and getting it again carries on where it stopped. Once it is there, the row says On this computer.

    Settings › Local models in the demo: LM Studio’s server running, Qwen3-Coder 30B with its with Claude Code and Not yet proven badges, on this computer, and Other models on this computer below. Current beta · demo
    The Local models section of Settings: an LM Studio group saying its server is running on a port, a Models Wanigan knows group with Qwen3-Coder 30B, two badges and a green On this computer badge, and a group for other models.
  3. Start a session on it

    In New session (On a Mac, ⌘T; on Windows and Linux, Ctrl+T), choose Claude Code, then the model under On this computer in the Model list. The first start loads it, which can take a minute. A local model takes no effort setting.

    New session’s Model list open with Claude Code chosen: the Claude models, Another model…, and Qwen3-Coder 30B under On this computer. Picture to come

    Picture: to come

    A screenshot of the real app, with the demo’s data, of what the title above says.

  4. Make it a project’s default

    In Project settings…, Local model › Start new sessions on makes the project’s new sessions start on it, and on its agent. The section appears once a local model is on your Mac.

Ollama and NVIDIA PAIR

If Ollama is running, or NVIDIA PAIR, which answers at Ollama’s address, its models are offered too, under On this computer, with Claude Code or Codex, and listed in Settings › Local models under Other models on this computer. Wanigan never downloads through them: add models with Ollama itself. A model they do not have refuses to start.

In depth

How accounts are found

  • The default folders. ~/.claude for Claude Code and ~/.codex for Codex are each listed as Default. The default account sets no variable when a session starts: pointing Claude Code’s CLAUDE_CONFIG_DIR at ~/.claude makes it read a different file and report a signed-in person as logged out. Any other Claude Code account is its folder as CLAUDE_CONFIG_DIR; a Codex account, its folder as CODEX_HOME.
  • Other folders. A folder in your home named .claude- or .claude_ and then a name (or .codex-, .codex_) is listed when it holds one of the files that agent keeps there, named after what follows the dash or underscore.
  • Who it is. Wanigan asks the agent itself, as that account: claude auth status --json for Claude Code; for Codex, its app server, falling back to codex login status. A missing credential file is not taken to mean signed out (on macOS the sign-in may be in the Keychain): only the agent’s own answer can say no.
  • Limits. claude -p "/usage" for Claude Code (a built-in command, not a model turn, run outside any project) and Codex’s app server for Codex, two accounts at a time, read again when older than ten minutes. A reading that fails says why, never shows a number.
  • One login, two folders. Two accounts count as one login only when both report the same email; they are flagged because they share limits.
  • Which account a session uses: the one you pick in New session, else the project’s, else the default. A CLAUDE_CONFIG_DIR or CODEX_HOME your shell exported is taken out for the session, so it runs as the account chosen.
  • Adding makes ~/.claude_<name> or ~/.codex_<name> (the name in lower case, other characters as underscores, a number added when it is taken), readable only by you. A name is 1 to 60 characters.
  • Removing is refused for the default (“Make another account the default first.”). A project that used a removed account falls back to the default.

What starting a local model does

Before Claude Code starts on an LM Studio model, Wanigan makes the model ready, and refuses with a reason at the first step that fails:

  1. The model must be in LM Studio. One not downloaded yet is refused: “Qwen3-Coder 30B is not on this Mac yet. Get it in Settings › Local models (17.2 GB).”
  2. LM Studio’s server is started if it is off, and its real port is read from lms server status --json: it is not always 1234.
  3. If the model is not loaded yet, LM Studio first estimates its memory (lms load --estimate-only) with room for an agent: 65,536 tokens of context for Qwen3-Coder 30B, because an agent’s instructions and tools alone take tens of thousands. A model LM Studio says will not fit is refused, saying how much it needs and “Close some apps and try again.”, rather than loaded until the Mac swaps.
  4. It is loaded with that context, and Claude Code is pointed at the local server for every model it might pick, the main one, helpers and subagents, with ANTHROPIC_API_KEY taken out so an account’s own key cannot win over the server.
  5. Claude Code is told to send Anthropic no telemetry or error reports (CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC), given 30-minute stream timeouts, since a local model can take minutes to read Claude Code’s opening prompt, and told the context the model was loaded with, so it compacts before it overflows.

Only a model Wanigan knows is downloaded, one attempt at a time. Free space must cover the whole model plus 10 GB; when Wanigan cannot read the free space, it refuses rather than guesses. The model is kept with the session, so resuming keeps it.

Wanigan looks for Ollama at 127.0.0.1:11434. Codex starts on one of its models with --oss --local-provider ollama; Claude Code is pointed at it as at LM Studio. Codex on an LM Studio model is given LM Studio’s real address, because Codex’s own LM Studio setting assumes port 1234.

Proven or not yet proven

A model that answers is not yet a model that works as an agent: an agent has to call tools, such as reading a file or running a command, in the form its CLI expects. So every model says whether its pairing with an agent has been proven: a real turn with a tool call, read back from Wanigan’s own record.

  • Proven, with when: that model and that agent did it.
  • Not yet proven: offered, and said so wherever you pick it: “Not yet proven with Claude Code: it may not use tools reliably.”
  • A model Wanigan has no description for, one you added to LM Studio or Ollama yourself, is offered as not proven with that agent.

npm run local:check, run from the source, is that proof: Claude Code on Qwen3-Coder through LM Studio, in the real app, the way you would do it (New session, the model, a request to read a file). It checks from Wanigan’s record that the session started on the local model, LM Studio loaded it with its context, the agent’s hooks reported a turn with a Read tool call, and the answer came back. It spends nothing, needs LM Studio with the model on disk, and is never part of npm test.