# Running BlockAssist with Cursor

### Prerequisites

Make sure you have **essential deverloper tools** installed by using the commands below, depending on your operating system (OS). 

{% tabs %}
{% tab title="Windows (WSL 2)" %}
Run this command inside your WSL 2 terminal

```bash
sudo apt update && sudo apt install -y build-essential curl git zip unzip
```

{% endtab %}

{% tab title="Linux" %}
Run this command inside your Ubuntu terminal:

```bash
sudo apt update && sudo apt install -y build-essential curl git zip unzip
```

{% endtab %}

{% tab title="macOS" %}
Run this command inside your macOS terminal:

```bash
xcode-select --install
```

{% endtab %}
{% endtabs %}

### Step 1 — Install Cursor

Go to the [Cursor website](https://cursor.com/) and click Download.

### Step 2 — Set up your Workspace

Open the Cursor app and, on the welcome screen, click *"Clone repo".*

1. Select GitHub from the dropdown and paste `https://github.com/gensyn-ai/blockassist/` 
2. Pick a local folder where the code will be downloaded.

Once the download finishes, Cursor will open your `blockassist` local folder.

### Step 3 — Install Dependencies

{% hint style="info" %}
You only need to do this once. To record additional episodes, skip to [Running BlockAssist.](https://docs.gensyn.ai/testnet/blockassist/using-blockassist)
{% endhint %}

You should be able to see the "Chat" panel of Cursor on the right side of the screen. If you don’t see the Chat panel, press `ctrl+L` (Windows/Linux) or `cmd+L` (macOS). 

In the chat window, enter the following prompt:

```
help me install the right dependencies for my operating system according to README.md
```

Cursor will now guide you through the installation steps of various dependencies needed to run BlockAssist. At the end, you should see a message saying the installation is complete.

{% hint style="warning" %}
**macOS Users:** You will need to give Cursor permission to minimize the Minecraft AI assistant window while you play the game. To do this, go to `System Settings` > `Privacy & Security` > `Accessibility` and set the toggle next to Cursor to `ON`.
{% endhint %}

## Troubleshooting

If you see any errors while trying to install or run BlockAssist, Cursor may be able to help you fix the issue and get unblocked.

Otherwise, you can go to the **troubleshooting guides** for your respective operating system by clicking the cards below:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Windows (WSL 2)</td><td><a href="../../getting-started/windows-wsl-2#troubleshooting">#troubleshooting</a></td></tr><tr><td>Linux</td><td><a href="../../getting-started/linux#troubleshooting">#troubleshooting</a></td></tr><tr><td>macOS</td><td><a href="../../getting-started/macos#troubleshooting">#troubleshooting</a></td></tr></tbody></table>

#### Handling Errors in Cursor

To help you understand and fix an error you see in your Terminal, go to the Chat panel on the right and enter the following prompt:&#x20;

```
Help me fix this error
```

* Make sure that Cursor AI can see the error, by clicking on `Add Context` in the chat box and then selecting `Terminal(s)`
* Alternatively, you can also copy and paste the error you see to the chat next to the prompt above.

If you don't see an error but BlockAssist isn't working as expected, you can also ask Cursor to look at your log files. Try using this prompt:&#x20;

```
Look at my logs folder and see if there are any errors preventing BlockAssist from running as expected
```

You can then follow the recommendations from Cursor to help you fix any issues and get unblocked.&#x20;

{% hint style="success" %}
If you need additional support, you can [open a ticket](https://github.com/gensyn-ai/blockassist/issues) or [visit our Discord.](https://discord.com/invite/gensyn)&#x20;
{% endhint %}