# Lagrange-cli

Lagrange-cli is a distributed version control tool, which means that a local clone of the project is a complete version control space in IPFS.

### How to install

**Clone and Install `lagrange-cli`:** Clone the `lagrange-cli` repository and install it using pip:

```bash
git clone https://github.com/lagrangedao/lagrange-cli.git
cd lagrange-cli
pip install .
```

> **Note**: To clone and Install `lagrange-cli` on the [testnet](https://testnet.lagrangedao.org/), switch to the `new_testnet` branch:
>
> ```bash
> git clone https://github.com/lagrangedao/lagrange-cli.git
> git checkout origin/new_testnet -b new_testnet
> pip install .
> ```

### **How to use**

**1. Copy Space Link:** After creating your space on Lagrange, copy the link. It will look like this: `https://lagrangedao.org/<type>/<wallet_address>/<name>`.

**2. Clone Your Space:** Open your terminal and run the following command to clone your space repository:

```bash
lag clone <space_link>
```

Replace `<space_link>` with the link, you copied in Step 1.

**3. Navigate to Folder:** Change your directory to the folder created during the clone. Its name matches your space's name:

```bash
cd <space_name>
```

**4. Add Code Files:** Copy your code files and paste them into the folder (same as your space's name).

**5. Add and Commit Files:** Inside the cloned repository, add the code files you want to commit:

```bash
lag add file1 file2 file3 ...
```

To add all files in the current directory and subdirectories:

```bash
lag add .
```

Commit the added files with a descriptive message:

```bash
lag commit -m "commit message"
```

**6.Configure API Token:**&#x20;

You will be prompted to set your API token. Go to your Lagrange **Profile→Settings→Access Tokens**, and get your access token.

In your terminal, use the following command to set your API token:

```bash
lag config --api-token <your_access_token>
```

Replace `<your_access_token>` with the token you obtained in the previous step.

<figure><img src="https://2830694519-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fy5iPODl9iwLxyYirHs2D%2Fuploads%2Fn10swqXpKyOSIfDXrNJ7%2Fimage.png?alt=media&#x26;token=dc77ec5e-7cce-4e49-b10a-0028a05f2cc3" alt=""><figcaption></figcaption></figure>

**7. Push Changes to Space:** Push your committed changes to your own Space using:

```bash
lag push <space_link>
```