Documentation

Documentation Reference

What Clauset writes

Every file setup, add and a running session put on your Mac, and which command writes it.

setup asks before each step and leaves a step out when its files are already in place. It leaves a status line of your own alone.

Files

PathWritten byWhat
~/.claude/clauset/config.tomlsetup, addThe accounts, the default and warn_at.
~/.claude/clauset/bin/claudesetupA link to the clauset binary: the shim.
~/.claude/clauset/bin/clausetsetupA link to the same binary, so the CLI is on PATH wherever the shim is.
~/.zshrc or ~/.bashrcsetupTwo lines at the end: a comment and export PATH="<home>/.claude/clauset/bin:$PATH", so the shim comes before every other claude. Another shell gets the line printed to add by hand.
~/.claude/settings.jsonsetupThe SessionStart and StopFailure hooks, and the statusLine when there's none. The file is written back whole, as JSON indented by two spaces, its keys in their order.
~/.claude/skills/clauset/SKILL.mdsetupThe /clauset skill, as shipped in skills/clauset/SKILL.md.
~/.claude/skills/accounts/SKILL.mdsetupThe accounts skill, as shipped in skills/accounts/SKILL.md.
~/.claude-accounts/<name>/add, loginA new account's config directory, with a link into the hub for every shared entry. add --dir uses the directory you name.
.claude.json of an account beside the hubadd, login, link, switchOnboarding, theme, the one-time dialogs the hub has answered, and the trust of every project the hub trusts. Keys the account has keep their values.
~/.claude/add --dirThe entries the taken-in directory has and the hub lacks.

Hooks, status line and skills shows the lines that go into settings.json.

While Clauset runs

All of it sits in ~/.claude/clauset/:

PathWhat
usage/Each account's usage, as clauset statusline last got it.
mcp/The hub's MCP servers in the shape --mcp-config reads, and chrome.json for the chrome key.
switch/A move a session asked for, until its supervisor carries it out.
supervised/<pid>.jsonThe account a supervised claude runs on, removed when it ends.
app.pidThe menu bar app's process id.
notify/Notifications waiting for the menu bar app, in a directory only you can write to.

Sign-ins

The Keychain item and the account's sign-in in its .claude.json come from claude auth login, which add and login start.

clauset remove <account> takes an account out of the config and drops its recorded usage. Its config directory and Keychain item stay.