---
title: CLI
description: "Learn how to generate components using CLI commands."
---

## Usage

:::warning
Before running the following commands, you need to install `@yamada-ui/cli` and execute the `init` command. For more details, please see [here](https://yamada-ui.com/docs/get-started/cli.md).
:::

### Add Components

When you run the `add` command, the specified component and its dependencies will be added to your project.

```bash
pnpm yamada-cli add box
```

```bash
npm yamada-cli add box
```

```bash
yarn yamada-cli add box
```

```bash
bun yamada-cli add box
```

:::note
All components that the specified component depends on will also be added.
:::

If you don't specify a component, all available components will be added.

```bash
pnpm yamada-cli add
```

```bash
npm yamada-cli add
```

```bash
yarn yamada-cli add
```

```bash
bun yamada-cli add
```

```bash
Usage: pnpm yamada-cli add [options] [components...]

add a component to your project

Arguments:
  components           components to add

Options:
  --cwd <path>         current working directory
  -c, --config <path>  path to the config file (default: "ui.json")
  -o, --overwrite      overwrite existing files. (default: false)
  -i, --install        install dependencies (default: false)
  -s, --sequential     run tasks sequentially. (default: false)
  -f, --format         format the output files.
  -l, --lint           lint the output files.
  -h, --help           display help for command
```

### Check Differences

When you run the `diff` command, you can check the difference between the local and remote components.

```bash
pnpm yamada-cli diff box
```

```bash
npm yamada-cli diff box
```

```bash
yarn yamada-cli diff box
```

```bash
bun yamada-cli diff box
```

If you don't specify a component, you can check the difference for all components in your project.

```bash
pnpm yamada-cli diff
```

```bash
npm yamada-cli diff
```

```bash
yarn yamada-cli diff
```

```bash
bun yamada-cli diff
```

```bash
Usage: pnpm yamada-cli diff [options] [component]

check for updates against the registry

Arguments:
  component            component to check

Options:
  --cwd <path>         current working directory
  -c, --config <path>  path to the config file (default: "ui.json")
  -s, --sequential     run tasks sequentially. (default: false)
  -d, --detail         show detailed changes (default: false)
  -h, --help           display help for command
```

### Update Components

When you run the `update` command, the specified component will be updated.

```bash
pnpm yamada-cli update box
```

```bash
npm yamada-cli update box
```

```bash
yarn yamada-cli update box
```

```bash
bun yamada-cli update box
```

If you don't specify a component, all components in your project will be updated.

```bash
pnpm yamada-cli update
```

```bash
npm yamada-cli update
```

```bash
yarn yamada-cli update
```

```bash
bun yamada-cli update
```

```bash
Usage: pnpm yamada-cli update [options] [components...]

update components in your project

Arguments:
  components           components to update

Options:
  --cwd <path>         current working directory
  -c, --config <path>  path to the config file (default: "ui.json")
  -i, --install        install dependencies (default: false)
  -s, --sequential     run tasks sequentially. (default: false)
  -f, --format         format the output files.
  -l, --lint           lint the output files.
  -h, --help           display help for command
```