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

# Azul CLI quick reference: commands at a glance

> A concise cheatsheet of the most common Azul commands for starting sync, building, pushing, packing, and configuring your project.

This page gives you the most common Azul commands at a glance. For full flag documentation and detailed descriptions, see the [commands reference](/commands).

## Start sync

Run `azul` from your project root to start the live sync daemon. Studio will connect automatically once you click **Connect** in the Azul plugin.

```bash theme={null}
azul
```

## Build local files into Studio

Use `azul build` for a one-time push from your local filesystem into Studio. Pass `--from-sourcemap` to build from a saved sourcemap, or use `--rojo` for Rojo-compatible projects.

<CodeGroup>
  ```bash Default build theme={null}
  azul build
  ```

  ```bash Build from sourcemap theme={null}
  azul build --from-sourcemap sourcemap.json
  ```

  ```bash Build with Rojo project theme={null}
  azul build --rojo --rojo-project default.project.json
  ```
</CodeGroup>

## Push a specific folder

Use `azul push` to sync a single local folder to a Studio destination path. Specify source and destination with `-s` and `-d`.

<CodeGroup>
  ```bash Push server scripts theme={null}
  azul push -s src/Server -d ServerScriptService.Server
  ```

  ```bash Push packages (destructive) theme={null}
  azul push -s Packages -d ReplicatedStorage.Packages --destructive --rojo
  ```
</CodeGroup>

## Generate sourcemap

Use `azul pack` to serialize your Studio instance properties into a `sourcemap.json` file. This file is used by tools like Luau LSP for type awareness.

<CodeGroup>
  ```bash Generate sourcemap theme={null}
  azul pack
  ```

  ```bash Generate sourcemap to a specific file theme={null}
  azul pack -o sourcemap.json --scripts-only
  ```
</CodeGroup>

## Open config

Use `azul config` to open your configuration file in your default editor, or print its path.

<CodeGroup>
  ```bash Open config file theme={null}
  azul config
  ```

  ```bash Print config file path theme={null}
  azul config --path
  ```
</CodeGroup>

## Global options

These flags work with `azul` and any subcommand.

| Flag                | Description                       |
| ------------------- | --------------------------------- |
| `--debug`           | Enable verbose logs               |
| `--no-warn`         | Skip confirmation prompts         |
| `--sync-dir [PATH]` | Override the sync directory       |
| `--port [NUMBER]`   | Override the daemon port          |
| `--help`, `-h`      | Show help for the current command |
| `--version`         | Print the installed Azul version  |

<Note>
  For the full flag reference with descriptions and examples, see [Azul CLI commands reference](/commands).
</Note>