# CLI reference

Reference for current Salambo source-deployment commands and global options.

Run:

```bash
salambo --help
```

for the exact command surface installed in your environment.

## Commands

| Command                    | Purpose                                                |
| -------------------------- | ------------------------------------------------------ |
| `salambo init <name>`      | Create a starter agent source project                  |
| `salambo auth set`         | Store or update the API URL and key                    |
| `salambo auth status`      | Show the selected authentication profile               |
| `salambo auth whoami`      | Verify the current key and workspace                   |
| `salambo auth logout`      | Remove stored profile credentials                      |
| `salambo doctor`           | Run read-only project and credential diagnostics       |
| `salambo manifest`         | Compile and print the agent manifest                   |
| `salambo deploy`           | Upload source and create an immutable deployment       |
| `salambo smoke [prompt]`   | Call the hosted Native Runs API for the deployed agent |
| `salambo agent create`     | Low-level agent API workflow                           |
| `salambo agent config set` | Low-level agent configuration workflow                 |

## Global options

| Option             | Purpose                                         |
| ------------------ | ----------------------------------------------- |
| `--profile <name>` | Select a named authentication profile           |
| `--api-url <url>`  | Override the profile API URL                    |
| `--file <path>`    | Use a non-default `salambo.yaml`                |
| `--json`           | Produce machine-readable output where supported |
| `--dry-run`        | Print planned work where supported              |
| `--help`, `-h`     | Show command help                               |

## Init template selection

Each CLI release pins an immutable version of the canonical managed-agent template. This prevents a previously released CLI from receiving a newer, incompatible project layout.

Use a custom Git template only when needed:

```bash
salambo init my-agent --template https://github.com/example/agent-template.git
salambo init my-agent --template https://github.com/example/agent-template.git --template-ref v1.2.0
```

## Manifest inspection

```bash
salambo manifest --path . --json
```

This command is the authoritative local view of the deployment manifest. It loads agent resources and hosted extensions and reports validation diagnostics.