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

# CLI Reference

> Complete reference for the Agent Stack command-line interface

The Agent Stack command-line interface (CLI) provides tools to manage agents, configure models, and control the platform directly from your terminal.

**Usage**:

```console theme={null}
$ agentstack [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.
* `--install-completion`: Install completion for the current shell.
* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.

**Commands**:

* `version`: Print version of the Agent Stack CLI.
* `ui`: Launch the graphical interface.
* `model`: Manage model providers.
* `agent`: Manage agents.
* `connector`: Manage connectors to external services.
* `platform`: Manage Agent Stack platform.
* `client-side-build`: Build agent locally using Docker.
* `build`: Build agent from a GitHub repository in...
* `server`: Manage Agent Stack servers and...
* `self`: Manage Agent Stack installation.
* `add`: Add a docker image or GitHub repository.
* `update`: Upgrade agent to a newer docker image or...
* `remove | uninstall | rm | delete`: Remove agent.
* `logs`: Stream agent provider logs.
* `run`: Run an agent.
* `list`: List agents.
* `info`: Show agent details.
* `env`
* `feedback`: Manage user feedback for your agents

## `agentstack version`

Print version of the Agent Stack CLI.

**Usage**:

```console theme={null}
$ agentstack version [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

## `agentstack ui`

Launch the graphical interface.

**Usage**:

```console theme={null}
$ agentstack ui [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `agentstack model`

Manage model providers. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack model [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `list`: List all available models.
* `setup`: Interactive setup for LLM and embedding...
* `change | select | default`: Change the default model \[Admin only]
* `add`: Add a new model provider.
* `remove | rm | delete`
* `provider`

### `agentstack model list`

List all available models.

**Usage**:

```console theme={null}
$ agentstack model list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

### `agentstack model setup`

Interactive setup for LLM and embedding provider environment variables \[Admin only]

**Usage**:

```console theme={null}
$ agentstack model setup [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--llm-provider TEXT`: LLM provider type (e.g. openai, anthropic, watsonx)
* `--llm-api-key TEXT`: LLM provider API key
* `--llm-base-url TEXT`: Base URL for 'other' LLM provider
* `--llm-watsonx-region TEXT`: IBM watsonx region for LLM (e.g. us-south)
* `--llm-watsonx-project-or-space TEXT`: IBM watsonx: 'project' or 'space'
* `--llm-watsonx-project-or-space-id TEXT`: IBM watsonx project or space ID for LLM
* `--llm-model TEXT`: Default LLM model ID (e.g. openai:gpt-4o)
* `--llm-bedrock-region TEXT`: AWS region for Bedrock LLM (e.g. us-east-1)
* `--llm-bedrock-access-key TEXT`: AWS Access Key ID for Bedrock LLM
* `--llm-bedrock-secret-key TEXT`: AWS Secret Access Key for Bedrock LLM
* `--embedding-provider TEXT`: Embedding provider type (e.g. openai, watsonx)
* `--embedding-api-key TEXT`: Embedding provider API key
* `--embedding-base-url TEXT`: Base URL for 'other' embedding provider
* `--embedding-watsonx-region TEXT`: IBM watsonx region for embedding
* `--embedding-watsonx-project-or-space TEXT`: IBM watsonx: 'project' or 'space'
* `--embedding-watsonx-project-or-space-id TEXT`: IBM watsonx project or space ID for embedding
* `--embedding-model TEXT`: Default embedding model ID
* `--embedding-bedrock-region TEXT`: AWS region for Bedrock embedding (e.g. us-east-1)
* `--embedding-bedrock-access-key TEXT`: AWS Access Key ID for Bedrock embedding
* `--embedding-bedrock-secret-key TEXT`: AWS Secret Access Key for Bedrock embedding
* `--skip-embedding`: Skip embedding provider setup
* `-y, --yes`: Skip confirmation prompts and auto-select recommended models
* `--help`: Show this message and exit.

### `agentstack model change | select | default`

Change the default model \[Admin only]

**Usage**:

```console theme={null}
$ agentstack model change | select | default [OPTIONS] [CAPABILITY]:[llm|embedding] [MODEL_ID]
```

**Arguments**:

* `[CAPABILITY]:[llm|embedding]`: Which default model to change (llm/embedding)
* `[MODEL_ID]`: Model ID to be used as default

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

### `agentstack model add`

Add a new model provider. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack model add [OPTIONS] [CAPABILITY]:[llm|embedding]
```

**Arguments**:

* `[CAPABILITY]:[llm|embedding]`: Which default model to change (llm/embedding)

**Options**:

* `--provider TEXT`: Provider type (e.g. openai, anthropic, watsonx)
* `--api-key TEXT`: Provider API key
* `--base-url TEXT`: Base URL for 'other' provider
* `--watsonx-region TEXT`: IBM watsonx region
* `--watsonx-project-or-space TEXT`: IBM watsonx: 'project' or 'space'
* `--watsonx-project-or-space-id TEXT`: IBM watsonx project or space ID
* `--bedrock-region TEXT`: AWS region for Bedrock (e.g. us-east-1)
* `--bedrock-access-key TEXT`: AWS Access Key ID for Bedrock
* `--bedrock-secret-key TEXT`: AWS Secret Access Key for Bedrock
* `--model TEXT`: Default model ID to use after adding the provider
* `-y, --yes`: Skip confirmation prompts and auto-select recommended model
* `--help`: Show this message and exit.

### `agentstack model remove | rm | delete`

**Usage**:

```console theme={null}
$ agentstack model remove | rm | delete [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Provider type or part of the provider base url

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

### `agentstack model provider`

**Usage**:

```console theme={null}
$ agentstack model provider [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `list`: List all available model providers.
* `add`: Add a new model provider \[Admin only]
* `remove | rm | delete`: Remove a model provider \[Admin only]

#### `agentstack model provider list`

List all available model providers.

**Usage**:

```console theme={null}
$ agentstack model provider list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

#### `agentstack model provider add`

Add a new model provider \[Admin only]

**Usage**:

```console theme={null}
$ agentstack model provider add [OPTIONS] [CAPABILITY]:[llm|embedding]
```

**Arguments**:

* `[CAPABILITY]:[llm|embedding]`: Which default model to change (llm/embedding)

**Options**:

* `--provider TEXT`: Provider type (e.g. openai, anthropic, watsonx)
* `--api-key TEXT`: Provider API key
* `--base-url TEXT`: Base URL for 'other' provider
* `--watsonx-region TEXT`: IBM watsonx region
* `--watsonx-project-or-space TEXT`: IBM watsonx: 'project' or 'space'
* `--watsonx-project-or-space-id TEXT`: IBM watsonx project or space ID
* `--bedrock-region TEXT`: AWS region for Bedrock (e.g. us-east-1)
* `--bedrock-access-key TEXT`: AWS Access Key ID for Bedrock
* `--bedrock-secret-key TEXT`: AWS Secret Access Key for Bedrock
* `--model TEXT`: Default model ID to use after adding the provider
* `-y, --yes`: Skip confirmation prompts and auto-select recommended model
* `--help`: Show this message and exit.

#### `agentstack model provider remove | rm | delete`

Remove a model provider \[Admin only]

**Usage**:

```console theme={null}
$ agentstack model provider remove | rm | delete [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Provider type or part of the provider base url

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

## `agentstack agent`

Manage agents. Some commands are \[Admin only].

**Usage**:

```console theme={null}
$ agentstack agent [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `add`: Add a docker image or GitHub repository.
* `update`: Upgrade agent to a newer docker image or...
* `remove | uninstall | rm | delete`: Remove agent.
* `logs`: Stream agent provider logs.
* `run`: Run an agent.
* `list`: List agents.
* `info`: Show agent details.
* `env`
* `feedback`: Manage user feedback for your agents

### `agentstack agent add`

Add a docker image or GitHub repository. \[Admin only]

This command supports a variety of GitHub URL formats for deploying agents:

* **Basic URL**: `https://github.com/myorg/myrepo`
* **Git Protocol URL**: `git+https://github.com/myorg/myrepo`
* **URL with .git suffix**: `https://github.com/myorg/myrepo.git`
* **URL with Version Tag**: `https://github.com/myorg/myrepo@v1.0.0`
* **URL with Branch Name**: `https://github.com/myorg/myrepo@my-branch`
* **URL with Subfolder Path**: `https://github.com/myorg/myrepo#path=/path/to/agent`
* **Combined Formats**: `https://github.com/myorg/myrepo.git@v1.0.0#path=/path/to/agent`
* **Enterprise GitHub**: `https://github.mycompany.com/myorg/myrepo`
* **With a custom Dockerfile location**: `agentstack add --dockerfile /my-agent/path/to/Dockerfile "https://github.com/my-org/my-awesome-agents@main#path=/my-agent"`

**Usage**:

```console theme={null}
$ agentstack agent add [OPTIONS] [LOCATION]
```

**Arguments**:

* `[LOCATION]`: Agent location (public docker image or github url)

**Options**:

* `--dockerfile TEXT`: Use custom dockerfile path
* `-v, --verbose`: Show verbose output
* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

### `agentstack agent update`

Upgrade agent to a newer docker image or build from GitHub repository. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent update [OPTIONS] [SEARCH_PATH] [LOCATION]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location of agent to replace
* `[LOCATION]`: Agent location (public docker image or github url)

**Options**:

* `--dockerfile TEXT`: Use custom dockerfile path
* `-v, --verbose`: Show verbose output
* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

### `agentstack agent remove | uninstall | rm | delete`

Remove agent. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent remove | uninstall | rm | delete [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `-a, --all`: Remove all agents without selection.
* `--help`: Show this message and exit.

### `agentstack agent logs`

Stream agent provider logs. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent logs [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]

**Options**:

* `--help`: Show this message and exit.

### `agentstack agent run`

Run an agent.

**Usage**:

```console theme={null}
$ agentstack agent run [OPTIONS] [SEARCH_PATH] [INPUT]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location
* `[INPUT]`: Agent input as text or JSON

**Options**:

* `--dump-files PATH`: Folder path to save any files returned by the agent
* `--help`: Show this message and exit.

### `agentstack agent list`

List agents.

**Usage**:

```console theme={null}
$ agentstack agent list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

### `agentstack agent info`

Show agent details.

**Usage**:

```console theme={null}
$ agentstack agent info [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]

**Options**:

* `--help`: Show this message and exit.

### `agentstack agent env`

**Usage**:

```console theme={null}
$ agentstack agent env [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `add`: Store environment variables.
* `list`: List stored environment variables.
* `remove`: Remove environment variable(s).

#### `agentstack agent env add`

Store environment variables. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent env add [OPTIONS] SEARCH_PATH ENV...
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]
* `ENV...`: Environment variables to pass to agent  \[required]

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

#### `agentstack agent env list`

List stored environment variables. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent env list [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]

**Options**:

* `--help`: Show this message and exit.

#### `agentstack agent env remove`

Remove environment variable(s). \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent env remove [OPTIONS] SEARCH_PATH ENV...
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]
* `ENV...`: Environment variable(s) to remove  \[required]

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

### `agentstack agent feedback`

Manage user feedback for your agents

**Usage**:

```console theme={null}
$ agentstack agent feedback [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `list`: List your agent feedback.

#### `agentstack agent feedback list`

List your agent feedback. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack agent feedback list [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location

**Options**:

* `--limit INTEGER`: Number of results per page   \[default: 50]
* `--after TEXT`: Cursor for pagination
* `--help`: Show this message and exit.

## `agentstack connector`

Manage connectors to external services.

**Usage**:

```console theme={null}
$ agentstack connector [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `create`: Create a connector to an external service.
* `remove | rm | delete`: Remove connectors.
* `list`: List all connectors.
* `list-presets`: List connector presets.
* `get`: Get connector details.
* `connect`: Connect a connector (e.g., start OAuth flow).
* `disconnect`: Disconnect one or more connectors.

### `agentstack connector create`

Create a connector to an external service.

**Usage**:

```console theme={null}
$ agentstack connector create [OPTIONS] URL
```

**Arguments**:

* `URL`: Agent location (public docker image or github url)  \[required]

**Options**:

* `--client-id TEXT`: Client ID for authentication, acquired from env if not supplied
* `--client-secret TEXT`: Client secret for authentication, acquired from env if not supplied
* `--metadata TEXT`: Metadata as JSON string
* `--match-preset`: Use preset configuration for given url if it exists  \[default: True]
* `--help`: Show this message and exit.

### `agentstack connector remove | rm | delete`

Remove connectors.

**Usage**:

```console theme={null}
$ agentstack connector remove | rm | delete [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID or connector url, supports partial matching

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `-a, --all`: Remove all connectors without selection.
* `--help`: Show this message and exit.

### `agentstack connector list`

List all connectors.

**Usage**:

```console theme={null}
$ agentstack connector list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

### `agentstack connector list-presets`

List connector presets.

**Usage**:

```console theme={null}
$ agentstack connector list-presets [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

### `agentstack connector get`

Get connector details.

**Usage**:

```console theme={null}
$ agentstack connector get [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID or connector url, supports partial matching  \[required]

**Options**:

* `--help`: Show this message and exit.

### `agentstack connector connect`

Connect a connector (e.g., start OAuth flow).

**Usage**:

```console theme={null}
$ agentstack connector connect [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID or connector url, supports partial matching  \[required]

**Options**:

* `--help`: Show this message and exit.

### `agentstack connector disconnect`

Disconnect one or more connectors.

**Usage**:

```console theme={null}
$ agentstack connector disconnect [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID or connector url, supports partial matching

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `-a, --all`: Deisconnect all connectors without selection.
* `--help`: Show this message and exit.

## `agentstack platform`

Manage Agent Stack platform. \[Local only]

**Usage**:

```console theme={null}
$ agentstack platform [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `start`: Start Agent Stack platform.
* `stop`: Stop Agent Stack platform.
* `delete`: Delete Agent Stack platform.
* `import`: Import a local docker image into the Agent...
* `exec`: For debugging -- execute a command inside...

### `agentstack platform start`

Start Agent Stack platform. \[Local only]

**Usage**:

```console theme={null}
$ agentstack platform start [OPTIONS]
```

**Options**:

* `--set TEXT`: Set Helm chart values using \<key>=\<value> syntax  \[default: \<class 'list'>]
* `--image-pull-mode [guest|host|hybrid|skip]`: guest = pull all images inside VM
  <span style="color: #000000; text-decoration-color: #000000">host = pull unavailable images on host, then import all</span>
  <span style="color: #000000; text-decoration-color: #000000">hybrid = import available images from host, pull the rest in VM</span>
  <span style="color: #000000; text-decoration-color: #000000">skip = skip explicit pull step (Kubernetes will attempt to pull missing images)  \[default: guest]</span>
* `-f PATH`: Set Helm chart values using yaml values file
* `--lima-image TEXT`: Local path or URL to Lima image (.qcow2)
* `--wsl-image TEXT`: Local path or URL to WSL distro image (.wsl)
* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

### `agentstack platform stop`

Stop Agent Stack platform. \[Local only]

**Usage**:

```console theme={null}
$ agentstack platform stop [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

### `agentstack platform delete`

Delete Agent Stack platform. \[Local only]

**Usage**:

```console theme={null}
$ agentstack platform delete [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

### `agentstack platform import`

Import a local docker image into the Agent Stack platform. \[Local only]

**Usage**:

```console theme={null}
$ agentstack platform import [OPTIONS] TAG
```

**Arguments**:

* `TAG`: Docker image tag to import  \[required]

**Options**:

* `-v, --verbose`: Show verbose output
* `--mode [daemon|registry]`: \[default: daemon]
* `--help`: Show this message and exit.

### `agentstack platform exec`

For debugging -- execute a command inside the Agent Stack platform VM. \[Local only]

**Usage**:

```console theme={null}
$ agentstack platform exec [OPTIONS] [COMMAND]...
```

**Arguments**:

* `[COMMAND]...`

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

## `agentstack client-side-build`

Build agent locally using Docker. \[Local only]

**Usage**:

```console theme={null}
$ agentstack client-side-build [OPTIONS] [CONTEXT]
```

**Arguments**:

* `[CONTEXT]`: Docker context for the agent  \[default: .]

**Options**:

* `--dockerfile TEXT`: Use custom dockerfile path
* `--tag TEXT`: Docker tag for the agent
* `--multi-platform / --no-multi-platform`: \[default: no-multi-platform]
* `--push / --no-push`: Push the image to the target registry.  \[default: no-push]
* `--import / --no-import`: Import the image into Agent Stack platform  \[default: import]
* `--extract-agent-card / --no-extract-agent-card`: Extract agent card from running container  \[default: extract-agent-card]
* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

## `agentstack build`

Build agent from a GitHub repository in the platform. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack build [OPTIONS] GITHUB_URL
```

**Arguments**:

* `GITHUB_URL`: Github repository URL (public or private if supported by the platform instance)  \[required]

**Options**:

* `--dockerfile TEXT`: Use custom dockerfile path, relative to github url sub-path
* `-v, --verbose`: Show verbose output
* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

## `agentstack server`

Manage Agent Stack servers and authentication.

**Usage**:

```console theme={null}
$ agentstack server [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `login | change | select | default | switch`: Login to a server or switch between logged...
* `logout | remove | rm | delete`
* `show`
* `list`

### `agentstack server login | change | select | default | switch`

Login to a server or switch between logged in servers.

**Usage**:

```console theme={null}
$ agentstack server login | change | select | default | switch [OPTIONS] [SERVER]
```

**Arguments**:

* `[SERVER]`

**Options**:

* `--client-id TEXT`: OAuth client ID (skips interactive prompt)
* `--client-secret TEXT`: OAuth client secret (skips interactive prompt)
* `--auth-server TEXT`: Authorization server URL (skips interactive selection)
* `--help`: Show this message and exit.

### `agentstack server logout | remove | rm | delete`

**Usage**:

```console theme={null}
$ agentstack server logout | remove | rm | delete [OPTIONS]
```

**Options**:

* `--all / --no-all`: \[default: no-all]
* `--help`: Show this message and exit.

### `agentstack server show`

**Usage**:

```console theme={null}
$ agentstack server show [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

### `agentstack server list`

**Usage**:

```console theme={null}
$ agentstack server list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `agentstack self`

Manage Agent Stack installation.

**Usage**:

```console theme={null}
$ agentstack self [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `version`: Print version of the Agent Stack CLI.
* `install`: Install Agent Stack platform pre-requisites.
* `upgrade`: Upgrade Agent Stack CLI and Platform to...
* `uninstall`: Uninstall Agent Stack CLI and Platform.

### `agentstack self version`

Print version of the Agent Stack CLI.

**Usage**:

```console theme={null}
$ agentstack self version [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

### `agentstack self install`

Install Agent Stack platform pre-requisites.

**Usage**:

```console theme={null}
$ agentstack self install [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `-y, --yes`: Skip confirmation prompts
* `--help`: Show this message and exit.

### `agentstack self upgrade`

Upgrade Agent Stack CLI and Platform to the latest version.

**Usage**:

```console theme={null}
$ agentstack self upgrade [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

### `agentstack self uninstall`

Uninstall Agent Stack CLI and Platform.

**Usage**:

```console theme={null}
$ agentstack self uninstall [OPTIONS]
```

**Options**:

* `-v, --verbose`: Show verbose output
* `--help`: Show this message and exit.

## `agentstack add`

Add a docker image or GitHub repository. \[Admin only]

This command supports a variety of GitHub URL formats for deploying agents:

* **Basic URL**: `https://github.com/myorg/myrepo`
* **Git Protocol URL**: `git+https://github.com/myorg/myrepo`
* **URL with .git suffix**: `https://github.com/myorg/myrepo.git`
* **URL with Version Tag**: `https://github.com/myorg/myrepo@v1.0.0`
* **URL with Branch Name**: `https://github.com/myorg/myrepo@my-branch`
* **URL with Subfolder Path**: `https://github.com/myorg/myrepo#path=/path/to/agent`
* **Combined Formats**: `https://github.com/myorg/myrepo.git@v1.0.0#path=/path/to/agent`
* **Enterprise GitHub**: `https://github.mycompany.com/myorg/myrepo`
* **With a custom Dockerfile location**: `agentstack add --dockerfile /my-agent/path/to/Dockerfile &quot;https://github.com/my-org/my-awesome-agents@main#path=/my-agent&quot;`

**Usage**:

```console theme={null}
$ agentstack add [OPTIONS] [LOCATION]
```

**Arguments**:

* `[LOCATION]`: Agent location (public docker image or github url)

**Options**:

* `--dockerfile TEXT`: Use custom dockerfile path
* `-v, --verbose`: Show verbose output
* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

## `agentstack update`

Upgrade agent to a newer docker image or build from GitHub repository. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack update [OPTIONS] [SEARCH_PATH] [LOCATION]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location of agent to replace
* `[LOCATION]`: Agent location (public docker image or github url)

**Options**:

* `--dockerfile TEXT`: Use custom dockerfile path
* `-v, --verbose`: Show verbose output
* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

## `agentstack remove | uninstall | rm | delete`

Remove agent. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack remove | uninstall | rm | delete [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `-a, --all`: Remove all agents without selection.
* `--help`: Show this message and exit.

## `agentstack logs`

Stream agent provider logs. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack logs [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]

**Options**:

* `--help`: Show this message and exit.

## `agentstack run`

Run an agent.

**Usage**:

```console theme={null}
$ agentstack run [OPTIONS] [SEARCH_PATH] [INPUT]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location
* `[INPUT]`: Agent input as text or JSON

**Options**:

* `--dump-files PATH`: Folder path to save any files returned by the agent
* `--help`: Show this message and exit.

## `agentstack list`

List agents.

**Usage**:

```console theme={null}
$ agentstack list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `agentstack info`

Show agent details.

**Usage**:

```console theme={null}
$ agentstack info [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]

**Options**:

* `--help`: Show this message and exit.

## `agentstack env`

**Usage**:

```console theme={null}
$ agentstack env [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `add`: Store environment variables.
* `list`: List stored environment variables.
* `remove`: Remove environment variable(s).

### `agentstack env add`

Store environment variables. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack env add [OPTIONS] SEARCH_PATH ENV...
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]
* `ENV...`: Environment variables to pass to agent  \[required]

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

### `agentstack env list`

List stored environment variables. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack env list [OPTIONS] SEARCH_PATH
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]

**Options**:

* `--help`: Show this message and exit.

### `agentstack env remove`

Remove environment variable(s). \[Admin only]

**Usage**:

```console theme={null}
$ agentstack env remove [OPTIONS] SEARCH_PATH ENV...
```

**Arguments**:

* `SEARCH_PATH`: Short ID, agent name or part of the provider location  \[required]
* `ENV...`: Environment variable(s) to remove  \[required]

**Options**:

* `-y, --yes`: Skip confirmation prompts.
* `--help`: Show this message and exit.

## `agentstack feedback`

Manage user feedback for your agents

**Usage**:

```console theme={null}
$ agentstack feedback [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `list`: List your agent feedback.

### `agentstack feedback list`

List your agent feedback. \[Admin only]

**Usage**:

```console theme={null}
$ agentstack feedback list [OPTIONS] [SEARCH_PATH]
```

**Arguments**:

* `[SEARCH_PATH]`: Short ID, agent name or part of the provider location

**Options**:

* `--limit INTEGER`: Number of results per page   \[default: 50]
* `--after TEXT`: Cursor for pagination
* `--help`: Show this message and exit.