---
title: "Guida introduttiva"
description: "Installa la CLI, avvia una sessione e unisci la tua prima richiesta di modifica."
---

Questa pagina ti guida da un terminale appena aperto a una richiesta di modifica (CR) unita.
Tutti i comandi qui sotto possono essere copiati e incollati.

1. <a id="install-the-cli"></a>

    ### Installa la CLI

    Esegui lo script di installazione. Scarica il binario `beeuni` per il tuo sistema operativo.

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

    Beeuni supporta macOS e Linux. Non è ancora disponibile un binario per Windows.

2. **Accedi**

    ```sh
    beeuni login
    ```

    Si apre il browser per consentirti di accedere. Dopo l'accesso, `beeuni login` seleziona il tuo account e un [progetto](/docs/it/project) predefinito.

3. <a id="create-or-clone-a-project"></a>

    ### Crea o clona un progetto

    Un nuovo account non ha ancora progetti, quindi `beeuni login` non ha nulla da selezionare. Esegui
    `beeuni init` con un nome per creare il tuo primo progetto. Verrà creata una struttura di directory per il progetto sul tuo computer.

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

    `beeuni ship` crea il progetto in Beeuni Cloud al primo avvio, quindi
    carica il tuo codice. Esegui di nuovo `beeuni ship` in qualsiasi momento per sincronizzare le modifiche locali.

    Per lavorare a un progetto già esistente in Beeuni Cloud, clonalo:

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

    Trova `<project-id>` con `beeuni projects ls`.

4. **Avvia una sessione**

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

    In questo modo avvii una [sessione](/docs/it/work/sessions). L'agente lavora nel proprio ambiente isolato e sul proprio branch, quindi il tuo progetto non viene ancora modificato.

    Collegati alla sessione per seguirne i progressi e rispondere:

    ```sh
    beeuni sessions chat
    ```

5. **Esamina e unisci la richiesta di modifica**

    Quando l'agente termina, apre una richiesta di modifica con un riepilogo e
    le differenze esatte.

    ```sh
    beeuni cr ls
    ```

    Questo comando elenca le CR aperte nel tuo progetto. Esamina quella aperta dall'agente, quindi
    uniscila per integrare il lavoro nel tuo branch predefinito:

    ```sh
    beeuni cr merge 1
    ```

    Sostituisci `1` con il numero della CR indicato da `beeuni cr ls`. Nesbeeuni modifica arriva al branch predefinito del tuo progetto finché non la unisci.

<a id="next-steps"></a>

## Prossimi passi

<CardGroup>
  <Card icon="route" title="Come si integrano i componenti" href="/docs/it/work">
    Una spiegazione di progetti, sessioni e richieste di modifica.
  </Card>
  <Card icon="terminal" title="Riferimento dei comandi CLI" href="/docs/it/cli">
    Tutti i comandi, i flag e i sottocomandi.
  </Card>
  <Card icon="terminal" title="Il ciclo di sviluppo con la CLI" href="/docs/it/cli">
    Collega un repository, distribuisci il codice e gestisci le sessioni dal terminale.
  </Card>
</CardGroup>