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

> CLI reference for buttons install

## buttons install

Install a button (or every button with a tag) from a source

### Synopsis

Install buttons from a source into your buttons directory.

The argument is one of:

```text theme={null}
  <name>            a single button (latest version)
  <name>@<version>  a pinned version
  tag:<tag>         every button in the source carrying <tag>
```

Each installed button's dependencies (its button.json "requires") are
installed too. Source + version + content hash are recorded in each
installed button.json for pinning and updates.

The registry source (buttons.co, #275) is not built yet; for now pass a
local source directory with --source (or \$BUTTONS\_SOURCE).

**Examples:**

```bash theme={null}
buttons install deploy --source ../button-source
buttons install tag:autono-cal --source ../button-source
buttons install deploy@1.2.0 --source ../button-source
```

```
buttons install <name | tag:x> [flags]
```

### Options

```
  -h, --help            help for install
      --source string   source directory to install from (until the registry lands, #275)
```

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