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

# facet help

> Show help for the CLI or a specific command

## Usage

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
facet --help
facet <command> --help
```

Prints usage information. With no command, shows the global help listing all available commands. With a command name, shows that command's usage, description, and flags.

## Exit codes

| Code | Meaning                                                                                               |
| ---- | ----------------------------------------------------------------------------------------------------- |
| `0`  | Help or version printed — including `facet help <unknown-topic>`, which falls back to the global help |
| `1`  | Unknown command (`facet <unknown-command>`)                                                           |

## Global help

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
facet --help
```

Lists every registered command with a short description. Aliases (e.g., `self-upgrade` for `self-update`) are listed alongside the canonical name. Stub commands (not yet implemented) are hidden from this output but still resolve for typo suggestions.

## Per-command help

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
facet add --help
facet build --help
facet adapter install --help
```

Shows the command's usage line, description, available flags with defaults, and a `--help` flag reference.

## Version

```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
facet --version
```

Prints the installed CLI version and exits.