harness-multitool

0026 — Profiles: every setting, and each window's sign-in

Decision

Every setting lives in a profile, a whole configuration of its own, and each window of the harness runs on one.

So one window can work under one Claude account, another under a second Claude account, a third on a ChatGPT plan, at the same time and without conflict. A window chooses its profile with multitool --profile <name> or from the settings' Profiles tab.

Where profiles live

All of a profile is in one folder, ~/.harness/profiles/<name>/. The folder belongs to the user's machine, not to a project. Profiles do not own conversations (CON-126):

~/.claude/                          the user's own Claude Code, used by plain claude and older harnesses; never touched
  .credentials.json
  projects/                         every Claude Code transcript, by project folder
~/.harness/
  shared.toml                       Telegram and voice, the same for every profile
  profiles/
    default/
      profile.toml                  the profile's settings
      chatgpt/                      its ChatGPT sign-in
      claude/                       its Claude Code directory
        .credentials.json           its own Claude login, made by claude auth login
        projects -> ~/.claude/projects     a link: the same transcripts as everyone
    work/                           the same layout, another account
~/.local/share/harness-multitool/   the daemon's data: the harness's log of each conversation, journals

A fresh install has default. Until its Claude Code directory is signed in, it runs on the user's own, so the conversation going on when profiles arrive keeps going.

Telegram and voice are in ~/.harness/shared.toml (the owner, 2026-11-10).

Why this way

Claude Code supports several accounts by design: each account has its own configuration directory, named by CLAUDE_CONFIG_DIR, holding its own login, settings and history (Authentication, "Log in with multiple accounts").

A profile names that directory, and signing in runs the unmodified claude auth login with it. The token stays in Claude Code's own store and the harness never sees it.

The owner first asked whether claude can take a token kept in the harness's config. It can (claude setup-token and CLAUDE_CODE_OAUTH_TOKEN).

But Anthropic's terms say developers may not collect, store or intermediate Claude.ai credentials (Legal and compliance), and CON-56 forbids it here. The directory route reaches the same goal inside the terms.

The harness already carries a window's environment to the daemon in memory, and the delegate runs with it; this is where a profile's directory and keys travel.

How a user signs in

  1. Settings, Profiles, Add, a name such as work. The profile is clean: defaults, and its own empty Claude Code directory, ~/.harness/profiles/work/claude/.

  2. Choose the Claude Code adapter in it, and press Sign in (or run multitool login claude-code --profile work).

  3. The harness hands the terminal to the unmodified claude auth login, run with that directory. The browser opens Anthropic's page; the user signs in with the account this profile is for, and Claude Code saves the login in that directory.

  4. The list shows the profile as signed in. Use in the tab (or Enter on its line) moves the window onto it:

    • every tab, the started ones too, goes on with its conversation under its sign-ins;
    • the next multitool starts on it (CON-127).

    multitool --profile work runs on it for one start only, for autostart.

No global sign-in is needed first, and no token is copied anywhere. Each profile's login is made once, into its own directory, and Claude Code refreshes it itself.

A second profile is the same steps; in the browser the user picks the other account.

The user's own ~/.claude is untouched; default runs on it until default's own directory is signed in, and every profile sees its transcripts through the projects link.

What is not per window

One daemon serves the machine, so what it holds once is shared: journals, maps, callbacks, the orchestra and Telegram.

Telegram's settings, and voice, which only sets how the daemon transcribes Telegram voice notes, are cross-profile: their own file, shared.toml, belonging to no profile (the owner, 2026-11-10).

Rejected

This page's source