> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orchestrahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> Five commands, five minutes: your agent sessions in your team's workspace

Run these in a terminal on macOS or Linux. On Windows, run them inside WSL2.

## 1. Install

```bash theme={null}
curl -fsSL https://get.orchestrahq.ai | sh
```

Puts one file, `orchestra`, in `~/.orchestra/bin`. No `sudo`, nothing sent.
**Next:** open a new terminal window so `orchestra` is on your `PATH`.

## 2. Sign in

```bash theme={null}
orchestra login
```

Opens your browser. Sign in and choose your workspace.
**Next:** the terminal says who you are signed in as.

## 3. Turn it on in a repository

```bash theme={null}
cd <your repository>
orchestra enable
```

Saves agent sessions in this repository and its worktrees from now on:
Claude Code, Codex, Gemini CLI, Cursor and OpenCode. Sessions in any other
folder are never read or sent. Run it again in each repository you want saved.
**Next:** a table of the agents it found, and a line naming the repository it saves.

`enable` follows sessions from now on. In a terminal it also offers to bring
in this repository's earlier sessions; step 4 covers the rest.

## 4. Bring in earlier sessions

```bash theme={null}
orchestra import
```

Shows what is here and sends nothing. Then it says what it would send,
including what summarizing them costs, and asks before it does.
**Next:** answer yes or no. It works in the background.

## 5. Open Orchestra

```bash theme={null}
orchestra
```

Opens the terminal client: your workspace's sessions, live first.
**Next:** press Enter to start a session (ctrl+p first makes it private).

## What leaves your machine

Only transcripts of agent sessions in repositories where you ran
`orchestra enable`. Secrets are removed on your machine first. Details, and
how to turn it off: [Install the CLI](https://docs.orchestrahq.ai/install-cli.md#what-leaves-your-machine).

If something seems off, run `orchestra doctor`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.