# crewrota docs

crewrota is a command line tool that runs Claude Code as one of your crew members.
A crew member is one Claude login in its own folder; a ship lets several members share history, so `--resume` finds a session another member started.
Install it with `npm install -g crewrota`, add a member with `crew add <member>`, and type `crew` to pick a member and start Claude.

![The crew menu with three members, their 5-hour and week bars, and the ship, model and effort line](https://crewrota.pasindug.com/docs/images/crew-menu.png)

## Who it is for

crewrota is for one person running their own Claude subscriptions.
If one plan runs out before your work does, you can keep each login signed in, carry your sessions across them, and see which one has room, without signing out and in again.
Your main `~/.claude` login is never touched: each member has its own folder under `~/.crewrota/members/`.

## What it does

- **One screen to start.** `crew` shows every member with its 5-hour and week bars; pick one, its ship, model and effort, and Claude Code opens as that login.
- **Usage at a glance.** `crew quota` in the terminal, `crew widget` on your desktop, a menu bar item on macOS (beta).
- **Shared history.** Members on the same ship share history, memory and MCP servers.
- **Your setup in every member.** Your skills, agents, commands, plugins, settings and `CLAUDE.md` come with every member.
- **Backup and restore.** One zip moves your ships, settings, skills and project `.claude` folders to a new machine. Logins are never in it.
- **firstmate.** A Claude Code plugin that hands a task to other members running headless.

## Your logins

crewrota never copies or moves a login; to read usage, quota-axi uses each member's own sign-in on your machine.
Each member signs in through Claude Code's own login, and that login stays in the member's folder.
Read [Your accounts and Anthropic's terms](https://crewrota.pasindug.com/docs/concepts/accounts-and-terms/) before you use several accounts.

## Where to start

### Get started

- [Install crewrota](https://crewrota.pasindug.com/docs/install/)
- [Your first crew in five minutes](https://crewrota.pasindug.com/docs/first-crew/)
- Quickstarts: [Windows](https://crewrota.pasindug.com/docs/windows/quickstart/), [macOS (beta)](https://crewrota.pasindug.com/docs/macos/quickstart/), [Linux (beta)](https://crewrota.pasindug.com/docs/linux/quickstart/)
- [Platforms and versions](https://crewrota.pasindug.com/docs/platforms/)

### Guides

- [Add and manage crew members](https://crewrota.pasindug.com/docs/guides/members/)
- [Share history between members with a ship](https://crewrota.pasindug.com/docs/guides/ships/)
- [Give a ship's members the same MCP servers](https://crewrota.pasindug.com/docs/guides/mcp-servers/)
- [Check every member's usage](https://crewrota.pasindug.com/docs/guides/usage-and-quota/)
- [Keep usage on your desktop with the widget](https://crewrota.pasindug.com/docs/guides/widget/)
- [Show usage in the macOS menu bar](https://crewrota.pasindug.com/docs/guides/macos-menu-bar/)
- [Open a folder as a member from VS Code](https://crewrota.pasindug.com/docs/guides/vscode-shortcuts/)
- [Move your crew to a new machine](https://crewrota.pasindug.com/docs/guides/backup-and-restore/)
- [Use your main setup in every member](https://crewrota.pasindug.com/docs/guides/main-setup/)
- [Choose whether Claude asks for permission](https://crewrota.pasindug.com/docs/guides/permissions/)
- [Fix a problem with crew doctor](https://crewrota.pasindug.com/docs/guides/troubleshooting/)

### Concepts

- [Members, ships and your main setup](https://crewrota.pasindug.com/docs/concepts/members-and-ships/)
- [What happens when a member launches](https://crewrota.pasindug.com/docs/concepts/launch/)
- [Where usage readings come from](https://crewrota.pasindug.com/docs/concepts/usage-readings/)

### Reference and agents

- [Every command](https://crewrota.pasindug.com/docs/commands/)
- [Guide for AI agents](https://crewrota.pasindug.com/docs/agents/)
- [Architecture, for contributors](https://crewrota.pasindug.com/docs/developers/architecture/)