---
title: Quickstart
description: Install the CLI, run a session, and merge your first change request.
---

Install the CLI, start a session, and merge your first change request (CR).

1. ### Install the CLI

    Run the install script. It downloads the `beeuni` binary for your OS.

    ```sh
    curl -fsSL https://beeuni.ai/install | bash
    ```

    Beeuni supports macOS and Linux. There is no Windows binary yet.

2. **Sign in**

    ```sh
    beeuni login
    ```

    This opens your browser for sign-in. After you sign in, `beeuni login` picks
    your account and a default [project](/docs/project) for you.

3. ### Create or clone a project

    A new account has no projects yet, so `beeuni login` has none to pick. Run
    `beeuni init` with a name to create your first project. This scaffolds a
    project directory on your machine.

    ```sh
    beeuni init my-app
    cd my-app
    beeuni ship
    ```

    `beeuni ship` creates the project in Beeuni Cloud on its first run, then
    pushes your code. Run `beeuni ship` again any time to sync local changes.

    To work on a project that already exists in Beeuni Cloud, clone it instead:

    ```sh
    beeuni projects clone <project-id>
    ```

    Find `<project-id>` with `beeuni projects ls`.

4. **Run a session**

    ```sh
    beeuni sessions new --prompt "Build the login page"
    ```

    This starts a [session](/docs/work/sessions). The agent works in its own
    sandbox and branch. Its file changes do not affect your project's default branch
    until you merge them.

    Attach to the session to watch progress and reply:

    ```sh
    beeuni sessions chat
    ```

5. **Review and merge the change request**

    When the agent finishes, it opens a change request with a summary and
    the exact diff.

    ```sh
    beeuni cr ls
    ```

    This lists the open CRs in your project. Review the one the agent opened, then
    merge it to land the work on your default branch:

    ```sh
    beeuni cr merge 1
    ```

    Replace `1` with the CR number from `beeuni cr ls`. Nothing reaches your
    project's default branch until you merge.

## Next steps

<CardGroup>
  <Card icon="route" title="How the pieces fit" href="/docs/work">
    Projects, sessions, and change requests, explained.
  </Card>
  <Card icon="terminal" title="CLI command reference" href="/docs/cli">
    Every command, flag, and subcommand.
  </Card>
  <Card icon="terminal" title="The CLI dev loop" href="/docs/cli">
    Link a repo, ship code, and manage sessions from your terminal.
  </Card>
</CardGroup>