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

# buttons add

> CLI reference for buttons add

## buttons add

Add a button dependency

### Synopsis

Add a registry button dependency to .buttons/buttons.json and install it.

Bare package names are not supported in the MVP. Use scoped names like
@autono/hello. Omit @version to track latest; include @version to pin
an exact immutable version.

**Examples:**

```bash theme={null}
buttons add @your-desk/hello
buttons add @your-desk/hello@1.2.3
```

```
buttons add @desk/name[@version] [flags]
```

### Options

```
  -h, --help   help for add
```

### Options inherited from parent commands

```
      --json       output in JSON format
      --no-input   disable all interactive prompts
      --summary    show a read-only plan/snapshot instead of mutating
```

### SEE ALSO

* [buttons](buttons.md)	 - Deterministic workflow engine for agents