# Documentation

How Clauset picks an account, what the accounts share, how a session moves and what Clauset writes on your Mac.

## Start here

Install Clauset, set up your accounts and meet the menu bar app.

- [Install Clauset](https://clauset.app/docs/start/install/index.md): Homebrew or Cargo, what Clauset needs, and how to upgrade.
- [Set up your accounts](https://clauset.app/docs/start/set-up/index.md): What `clauset setup` asks, and the first commands to run after it.
- [The menu bar app](https://clauset.app/docs/start/menu-bar-app/index.md): What the app shows, what its menus do, and how it updates.

## Accounts

Which account a session starts on, how to add one, and what the accounts share.

- [Which account a session starts on](https://clauset.app/docs/accounts/which-account/index.md): The rule the `claude` shim follows, and the commands that change the answer.
- [Add, sign in and remove accounts](https://clauset.app/docs/accounts/add-and-remove/index.md): A new account, a config directory you already use, signing in again and taking an account out.
- [What accounts share](https://clauset.app/docs/accounts/what-accounts-share/index.md): What every account reads from the hub, what stays per account, and where MCP servers and plugins come from.
- [Claude in Chrome on every account](https://clauset.app/docs/accounts/claude-in-chrome/index.md): Name the account the browser extension is signed in to, and every other account reaches the same browser.

## Sessions and limits

Move a running session to another account, and see how much of each limit is used.

- [Move a session to another account](https://clauset.app/docs/sessions/move-a-session/index.md): `clauset switch` ends a running session once its turn is over and resumes it on another account, in the same terminal.
- [Usage and warnings](https://clauset.app/docs/sessions/usage-and-warnings/index.md): Where the usage numbers come from, how to read the bars, and when Clauset warns you.

## Reference

The config file, every file Clauset writes, and the Claude Code behaviour it rests on.

- [The config file](https://clauset.app/docs/reference/config-file/index.md): Where the config lives, which commands write it, and what each key means.
- [What Clauset writes](https://clauset.app/docs/reference/files/index.md): Every file `setup`, `add` and a running session put on your Mac, and which command writes it.
- [Hooks, status line and skills](https://clauset.app/docs/reference/hooks-status-line-and-skills/index.md): What `setup` adds to Claude Code: two hooks, a status line command and two skills.
- [For programs and agent tools](https://clauset.app/docs/reference/programs/index.md): Start Claude Code on a chosen account, and read or carry out Clauset's state from a program.
- [Undocumented behaviour Clauset relies on](https://clauset.app/docs/reference/undocumented-behaviour/index.md): What Clauset takes from Claude Code without a documented promise, and what breaks if it changes.
