> ## 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.

```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
```

## 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`.

```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
```

## 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.

```bash Generate sourcemap theme={null}
azul pack
```

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

## Open config

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

```bash Open config file theme={null}
azul config
```

```bash Print config file path theme={null}
azul config --path
```

## 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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.