Skip to main content
The Agent Stack command-line interface (CLI) provides tools to manage agents, configure models, and control the platform directly from your terminal. Usage: 
$ agentstack [OPTIONS] COMMAND [ARGS]...
Options:
  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.
Commands:
  • version: Print version of the Agent Stack CLI.
  • ui: Launch the graphical interface.
  • model: Manage model providers.
  • agent: Manage agents.
  • platform: Manage Agent Stack platform.
  • mcp: Manage MCP servers and toolkits.
  • 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.
  • user: Manage users.
  • 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: 
$ agentstack version [OPTIONS]
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack ui

Launch the graphical interface. Usage: 
$ agentstack ui [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack model

Manage model providers. Usage: 
$ agentstack model [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • list
  • setup: Interactive setup for LLM and embedding…
  • change | select | default
  • add
  • remove | rm | delete
  • provider

​
agentstack model list

Usage: 
$ agentstack model list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack model setup

Interactive setup for LLM and embedding provider environment variables Usage: 
$ agentstack model setup [OPTIONS]
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack model change | select | default

Usage: 
$ 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

Usage: 
$ agentstack model add [OPTIONS] [CAPABILITY]:[llm|embedding]
Arguments:
  • [CAPABILITY]:[llm|embedding]: Which default model to change (llm/embedding)
Options:
  • --help: Show this message and exit.

​
agentstack model remove | rm | delete

Usage: 
$ 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: 
$ agentstack model provider [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • list
  • add
  • remove | rm | delete

​
agentstack model provider list

Usage: 
$ agentstack model provider list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack model provider add

Usage: 
$ agentstack model provider add [OPTIONS] [CAPABILITY]:[llm|embedding]
Arguments:
  • [CAPABILITY]:[llm|embedding]: Which default model to change (llm/embedding)
Options:
  • --help: Show this message and exit.

​
agentstack model provider remove | rm | delete

Usage: 
$ 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. Usage: 
$ 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 Usage: 
$ 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 Usage: 
$ 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 Usage: 
$ agentstack agent remove | uninstall | rm | delete [OPTIONS] SEARCH_PATH
Arguments:
  • SEARCH_PATH: Short ID, agent name or part of the provider location [required]
Options:
  • -y, --yes: Skip confirmation prompts.
  • --help: Show this message and exit.

​
agentstack agent logs

Stream agent provider logs Usage: 
$ 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: 
$ 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: 
$ agentstack agent list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack agent info

Show agent details. Usage: 
$ 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: 
$ agentstack agent env [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • add: Store environment variables
  • list: List stored environment variables
  • remove

​
agentstack agent env add

Store environment variables Usage: 
$ 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 Usage: 
$ 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

Usage: 
$ 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: 
$ 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 Usage: 
$ 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 platform

Manage Agent Stack platform. Usage: 
$ 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. Usage: 
$ agentstack platform start [OPTIONS]
Options:
  • --set TEXT: Set Helm chart values using <key>=<value> syntax [default: <class ‘list’>]
  • --import TEXT: Import an image from a local Docker CLI into Agent Stack platform [default: <class ‘list’>]
  • -f PATH: Set Helm chart values using yaml values file
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack platform stop

Stop Agent Stack platform. Usage: 
$ agentstack platform stop [OPTIONS]
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack platform delete

Delete Agent Stack platform. Usage: 
$ 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. Usage: 
$ agentstack platform import [OPTIONS] TAG
Arguments:
  • TAG: Docker image tag to import [required]
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack platform exec

For debugging — execute a command inside the Agent Stack platform VM. Usage: 
$ agentstack platform exec [OPTIONS] [COMMAND]...
Arguments:
  • [COMMAND]...
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack mcp

Manage MCP servers and toolkits. Usage: 
$ agentstack mcp [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • add: Install discovered MCP server.
  • list: List MCP servers.
  • remove | uninstall | rm | delete: Remove MCP server.
  • tool: Inspect tools.
  • toolkit: Create toolkits.

​
agentstack mcp add

Install discovered MCP server. Usage: 
$ agentstack mcp add [OPTIONS] NAME LOCATION [TRANSPORT]:[sse|streamable_http]
Arguments:
  • NAME: Name for the MCP server [required]
  • LOCATION: Location of the MCP server [required]
  • [TRANSPORT]:[sse|streamable_http]: Transport the MCP server uses [default: streamable_http]
Options:
  • -y, --yes: Skip confirmation prompts.
  • --help: Show this message and exit.

​
agentstack mcp list

List MCP servers. Usage: 
$ agentstack mcp list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack mcp remove | uninstall | rm | delete

Remove MCP server. Usage: 
$ agentstack mcp remove | uninstall | rm | delete [OPTIONS] NAME
Arguments:
  • NAME: Name of the MCP provider to remove [required]
Options:
  • -y, --yes: Skip confirmation prompts.
  • --help: Show this message and exit.

​
agentstack mcp tool

Inspect tools. Usage: 
$ agentstack mcp tool [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • list: List tools.

​
agentstack mcp tool list

List tools. Usage: 
$ agentstack mcp tool list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack mcp toolkit

Create toolkits. Usage: 
$ agentstack mcp toolkit [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • create: Create a toolkit.

​
agentstack mcp toolkit create

Create a toolkit. Usage: 
$ agentstack mcp toolkit create [OPTIONS] TOOLS...
Arguments:
  • TOOLS...: Tools to put in the toolkit [required]
Options:
  • -y, --yes: Skip confirmation prompts.
  • --help: Show this message and exit.

​
agentstack client-side-build

Build agent locally using Docker. Usage: 
$ 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]
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack build

Build agent from a GitHub repository in the platform. Usage: 
$ 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: 
$ 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: 
$ agentstack server login | change | select | default | switch [OPTIONS] [SERVER]
Arguments:
  • [SERVER]
Options:
  • --help: Show this message and exit.

​
agentstack server logout | remove | rm | delete

Usage: 
$ agentstack server logout | remove | rm | delete [OPTIONS]
Options:
  • --all / --no-all: [default: no-all]
  • --help: Show this message and exit.

​
agentstack server show

Usage: 
$ agentstack server show [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack server list

Usage: 
$ agentstack server list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack self

Manage Agent Stack installation. Usage: 
$ 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: 
$ 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: 
$ agentstack self install [OPTIONS]
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack self upgrade

Upgrade Agent Stack CLI and Platform to the latest version. Usage: 
$ 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: 
$ agentstack self uninstall [OPTIONS]
Options:
  • -v, --verbose: Show verbose output
  • --help: Show this message and exit.

​
agentstack user

Manage users. Usage: 
$ agentstack user [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • list: List platform users (admin only).
  • set-role: Change user role (admin only).

​
agentstack user list

List platform users (admin only). Usage: 
$ agentstack user list [OPTIONS]
Options:
  • --email TEXT: Filter by email (case-insensitive partial match)
  • --limit INTEGER: Results per page (1-100) [default: 40]
  • --after TEXT: Pagination cursor (page_token)
  • --help: Show this message and exit.

​
agentstack user set-role

Change user role (admin only). Usage: 
$ agentstack user set-role [OPTIONS] USER_ID ROLE:{admin|developer|user}
Arguments:
  • USER_ID: User UUID [required]
  • ROLE:{admin|developer|user}: Target role (admin, developer, user) [required]
Options:
  • -y, --yes: Skip confirmation prompts.
  • --help: Show this message and exit.

​
agentstack add

Add a docker image or GitHub repository Usage: 
$ 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 Usage: 
$ 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 Usage: 
$ agentstack remove | uninstall | rm | delete [OPTIONS] SEARCH_PATH
Arguments:
  • SEARCH_PATH: Short ID, agent name or part of the provider location [required]
Options:
  • -y, --yes: Skip confirmation prompts.
  • --help: Show this message and exit.

​
agentstack logs

Stream agent provider logs Usage: 
$ 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: 
$ 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: 
$ agentstack list [OPTIONS]
Options:
  • --help: Show this message and exit.

​
agentstack info

Show agent details. Usage: 
$ 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: 
$ agentstack env [OPTIONS] COMMAND [ARGS]...
Options:
  • --help: Show this message and exit.
Commands:
  • add: Store environment variables
  • list: List stored environment variables
  • remove

​
agentstack env add

Store environment variables Usage: 
$ 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 Usage: 
$ 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

Usage: 
$ 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: 
$ 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 Usage: 
$ 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.