# `chock install`

Ask the user before running chock install: what it takes and prints, from the engine at the pinned commit.

Build a chock.sh selection into one plugin for one agent (install --selection \<file\> \[--client C\])

> Ask the user before running any command on this page: each one changes how their agent or repository behaves.

## Syntax

This is the usage line argparse builds from this command's parser. Ask the user before running the commands below:

```text
chock install [-h] --selection SELECTION
              [--client {claude-code,copilot,codex,cursor,devin,goose,grok,antigravity,openhands,kimi-code,factory-droid}]
              [--dest DEST] [--marketplace-name NAME] [--apply] [--allow-source SOURCE]
              [--trust-local ID=SHA256]
```

## Arguments and options

The table lists every argument the parser declares, except `-h, --help`, written as argparse prints it. Default is the value the parser uses when you leave the option out. It is empty for a flag or when the parser sets none. Help for each argument is in the table on this page's HTML version and in Help as printed, as the engine words it.

| Argument | Default |
| --- | --- |
| `--selection SELECTION` (required) |  |
| `--client` one of: claude-code, copilot, codex, cursor, devin, goose, grok, antigravity, openhands, kimi-code, factory-droid, gemini-cli |  |
| `--dest DEST` |  |
| `--marketplace-name NAME` |  |
| `--apply` |  |
| `--allow-source SOURCE` | `[]` |
| `--trust-local ID=SHA256` | `[]` |

## Exit codes

- 2: argparse rejected the arguments, for example an option this command does not have. The site's tests run every command with an unknown option and check that it exits 2.
- Chock documents no other exit codes, and this page has no recorded run.

## Help as printed

This is what `--help` prints, from the same parser. The usage line names the program as the engine's parser does. Ask the user before running the commands below:

```text
usage: chock install [-h] --selection SELECTION
                     [--client {claude-code,copilot,codex,cursor,devin,goose,grok,antigravity,openhands,kimi-code,factory-droid}]
                     [--dest DEST] [--marketplace-name NAME] [--apply] [--allow-source SOURCE]
                     [--trust-local ID=SHA256]
```

The full options are on this page's HTML version, as the engine prints them.


---

Built from engine [5a4b6287a46e](https://github.com/open-coder-ai/chock/commit/5a4b6287a46e07f9f856d9bbe10622bd1ff2e021) and catalog [1e60d211c1bb](https://github.com/open-coder-ai/chock-catalog/commit/1e60d211c1bb767152c6ab0167932da06ab3a10f).