Several subscriptions side by side (beta)

Beta. This feature has been checked by automated tests and not yet by use across a real day of work. It should do nothing at all until you configure an account, but if something looks wrong on an account cell, please file it (the mulmoterminal-bug-report skill helps).

For someone with more than one Claude Code or Codex subscription who wants some cells on each — say six cells, two of them on the work subscription.

  1. What you get
  2. 1. Add the account to the config
  3. 2. Restart and reload
  4. 3. Start the first cell and log in
  5. 4. Let the usage check in (Claude accounts)
  6. What the toolbar shows
  7. Things that do not work, on purpose
  8. Removing an account

What you get

  • A new cell can be started on a second login (an account). The cell beside it keeps running on your usual login.
  • The cell’s header names the account it runs on.
  • The resume list shows the sessions of every account, each named with its account. A session always continues on the account it was started on.
  • The toolbar shows each account’s 5h / 7d usage beside your usual login’s.

If you configure nothing, none of this appears and nothing changes.

1. Add the account to the config

Open ~/.mulmoterminal/config.json and add an accounts list. Each entry names a config directory of its own. The directory does not have to exist yet.

{
  "accounts": [
    { "id": "work", "label": "Work", "agent": "claude", "home": "~/.claude-work" },
    { "id": "personal", "label": "Personal", "agent": "codex", "home": "~/.codex-personal" }
  ]
}
  • id is how sessions are remembered. Choose it once. To show a different name, change label.
  • agent is "claude" or "codex".
  • home must be absolute or start with ~/. Do not use ~/.claude or ~/.codex itself. That is your usual login’s directory: a cell on such an account simply runs on your usual login, and the account gets no gauge of its own.

Every key and limit is in the reference: Configuration → accounts. Or ask /mulmoterminal-model to write the entry for you.

2. Restart and reload

The list is read at startup. Restart MulmoTerminal, then reload the browser tab.

Or skip steps 1 and 2: Settings → Models and backends adds an account under Second subscriptions (a name, Claude Code or Codex, and the directory), and it is offered in the launch form at once. The id is made from the name there.

How to tell it worked: Settings → Models and backends lists the account under Second subscriptions.

Settings, Models and backends: the Second subscriptions list with three accounts

3. Start the first cell and log in

  1. In an empty cell, pick the agent (Claude or Codex). An ACCOUNT select appears under the model. It offers Default login followed by your accounts.
  2. Pick the account and launch.

    The launch form with the ACCOUNT select set to Work

  3. If the directory is new, or has never been logged in, the CLI asks you to log in. For Claude Code, run /login and sign in with the subscription you want on this account. The login is kept in that directory from now on.

The header of that cell now shows the account’s name.

A cell's header naming the Work account

An account on a new directory starts empty: your settings, your own MCP servers and the per-project trust answers belong to your usual login. A directory you already used with CLAUDE_CONFIG_DIR or CODEX_HOME keeps whatever it holds, login included. MulmoTerminal’s own parts do follow the account: the bundled mulmoterminal-* skills are installed into its directory, and a cell on it gets the same GUI tools as any other cell in that directory.

4. Let the usage check in (Claude accounts)

A Claude account’s usage is measured the way your usual login’s is: by a short hidden session in a folder of MulmoTerminal’s own, ~/.mulmoterminal/probe, run on that account’s login. Claude Code asks whether to trust a folder the first time it runs there, and nobody can answer for a hidden session — so MulmoTerminal records the answer itself, in the account’s own Claude Code config (.claude.json in the account’s directory), before the first check. Normally there is nothing to do.

If the toolbar still shows Work n/a and the hover text names the trust prompt, the answer could not be written: the account has never run claude and so has no config yet, or the file could not be read. Clear it once by hand:

  1. Start a cell on the account in that folder: in the launch form, type ~/.mulmoterminal/probe as the Working directory, with the account selected.
  2. Accept the trust prompt.

The check retries by itself, less often each time (up to an hour apart). Restarting the server resets that wait, so the gauge appears sooner.

A Codex account needs none of this. Its usage is read from its own session files after the first session there.

What the toolbar shows

The toolbar: Lab n/a, the default login's Claude and Codex figures, then Work and Personal

You see Meaning
Work 5h 12% 7d 40% The account’s windows, named with its label
Work n/a A Claude account that cannot be measured yet. The hover text says why: the trust prompt (step 4), no answer yet (not logged in, or the check is retrying), or API-key billing (no windows)
Work at limit A Claude account that is out of its allowance, in the warning colour. The hover text says when its windows were last due to reset
/login 5h 2% 7d 0% Your usual login’s windows, labelled /login once an account or a rotation token for the same tool is on the row
nothing for an account Not measured yet, or a Codex account with no session yet

Once any account is on the row, every set of figures carries its tool’s mark and your usual login’s own entry for that tool is labelled /login, so its figures cannot be mistaken for an account’s.

Things that do not work, on purpose

  • Changing a session’s account. A session stays on the account it was started on, whatever the select says later. Its transcript lives in that account’s directory.
  • Putting CLAUDE_CONFIG_DIR or CODEX_HOME in a custom agent’s command or a provider’s env. MulmoTerminal would look in the usual directory while the session writes elsewhere, and the session list, resume, cost and history would come back empty. Use accounts instead.
  • Two accounts on one directory. They are one login, so the toolbar shows it once, under the first one’s label.

Removing an account

Delete the entry and restart. A cell that is still open keeps running on that directory, and its header then shows the account’s bare id. The account’s older sessions are no longer listed for resume, because only the directories of configured accounts are read. To get them back in the list, add the entry again with the same id and home. The directory and its login are yours to delete.


This site uses Just the Docs, a documentation theme for Jekyll.