Documentation Index

Fetch the complete documentation index at: https://docs.meshagent.com/llms.txt

Use this file to discover all available pages before exploring further.

​

meshagent

$ meshagent [OPTIONS] COMMAND [ARGS]...

• --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.

• version: Print the version
• setup: Perform initial login and project/api key…
• auth: Authenticate to meshagent
• project: Manage or activate your meshagent projects
• api-key: Manage or activate api-keys for your project
• config: Read MeshAgent deployment configuration
• session: Inspect recent sessions and events
• ask: Send a one-shot LLM prompt.
• launch: Launch supported CLI apps through MeshAgent.
• token: Generate a participant token (JWT) from a…
• webhook: Manage project webhooks
• service: Manage services for your project
• mcp: Bridge MCP servers into MeshAgent rooms
• secret: Manage secrets for your project.
• rooms: Create, list, and manage rooms in a project
• mailbox: Manage mailboxes for your project
• feed: Manage feeds for your project
• subscription: Manage feed subscriptions for your project
• route: Manage routes for your project
• registry: Manage registries for your project
• build: Build a container image inside a room.
• deploy: Create or update a room service from an…
• scheduled-task: Manage scheduled tasks for your project
• meeting-transcriber: Join a meeting transcriber to a room
• port: Forward a container port to localhost
• voicebot: Join a voicebot to a room
• process: Join a process-backed agent to a room
• room: Operate within a room
• llm: Local LLM proxy utilities

​

meshagent version

$ meshagent version [OPTIONS]

• --help: Show this message and exit.

​

meshagent setup

$ meshagent setup [OPTIONS]

• --api-url TEXT: Persist this API URL on the saved profile and use it for setup login.
• --help: Show this message and exit.

​

meshagent auth

$ meshagent auth [OPTIONS] COMMAND [ARGS]...

• --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.

• login
• logout
• switch
• whoami
• token

​

meshagent auth login

$ meshagent auth login [OPTIONS]

• --api-url TEXT: Persist this API URL on the saved profile and use it for this login.
• --help: Show this message and exit.

​

meshagent auth logout

$ meshagent auth logout [OPTIONS]

• --help: Show this message and exit.

​

meshagent auth switch

$ meshagent auth switch [OPTIONS] [PROFILE]

• [PROFILE]: Saved profile user id or email. If omitted, saved profiles are listed or an interactive picker is shown in a TTY.

• --help: Show this message and exit.

​

meshagent auth whoami

$ meshagent auth whoami [OPTIONS]

• --help: Show this message and exit.

​

meshagent auth token

$ meshagent auth token [OPTIONS]

• --help: Show this message and exit.

​

meshagent project

$ meshagent project [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a new MeshAgent project.
• list: List projects and mark the currently…
• activate: Set the active project for subsequent CLI…

​

meshagent project create

$ meshagent project create [OPTIONS] NAME

• NAME: [required]

• --help: Show this message and exit.

​

meshagent project list

$ meshagent project list [OPTIONS]

• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent project activate

$ meshagent project activate [OPTIONS] [PROJECT_ID]

• [PROJECT_ID]: Project id. If omitted, an interactive picker is shown in a TTY.

• -i, --interactive: Interactively select or create a project. Uses the TUI in a TTY.
• --help: Show this message and exit.

​

meshagent api-key

$ meshagent api-key [OPTIONS] COMMAND [ARGS]...

• --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.

• list: List API keys for a project.
• create: Create a new API key for a project.
• show: Show the activated API key for a project.
• env: Print the activated API key as a shell…
• activate: Set the default API key for a project in…
• delete: Delete an API key from a project.

​

meshagent api-key list

$ meshagent api-key list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent api-key create

$ meshagent api-key create [OPTIONS] NAME

• NAME: [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --description TEXT: a description for the api key
• --activate / --no-activate: use this key by default for commands that accept an API key [default: no-activate]
• --silent / --no-silent: do not print api key [default: no-silent]
• --help: Show this message and exit.

​

meshagent api-key show

$ meshagent api-key show [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent api-key env

$ meshagent api-key env [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent api-key activate

$ meshagent api-key activate [OPTIONS] KEY

• KEY: [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent api-key delete

$ meshagent api-key delete [OPTIONS] ID

• ID: [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent config

$ meshagent config [OPTIONS] COMMAND [ARGS]...

• --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.

• get: Print one deployment config value.

​

meshagent config get

$ meshagent config get [OPTIONS] PATH

• PATH: Config path to read, for example domains.pages [required]

• --help: Show this message and exit.

​

meshagent session

$ meshagent session [OPTIONS] COMMAND [ARGS]...

• --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.

• list: List recent sessions
• show: Show events for a session
• traces: List trace spans for a session as a tree

​

meshagent session list

$ meshagent session list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --limit INTEGER RANGE: Maximum sessions to return (server max 1000) [default: 25; x>=1]
• --room TEXT: Only include sessions for the given room name
• --help: Show this message and exit.

​

meshagent session show

$ meshagent session show [OPTIONS] SESSION_ID

• SESSION_ID: [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent session traces

$ meshagent session traces [OPTIONS] [SESSION_ID]

• [SESSION_ID]: Session id to inspect

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Use the most recent session for this room
• --trace-id TEXT: Only include spans from this trace
• --name TEXT: Only include spans whose name contains this text
• --min-duration TEXT: Only include spans at or above this duration, e.g. 500ms or 2s
• --attrs: Include span attributes
• --help: Show this message and exit.

​

meshagent ask

$ meshagent ask [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -m, --message TEXT: Prompt to send to the LLM
• --format TEXT: Output format for non-interactive responses. [default: text]
• --model TEXT: Name of the LLM model to use [default: gpt-5.5]
• --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.

​

meshagent launch

$ meshagent launch [OPTIONS] COMMAND [ARGS]...

• --help: Show this message and exit.

• codex: Launch Codex through MeshAgent for the…
• claude: Launch Claude through MeshAgent for the…

​

meshagent launch codex

$ meshagent launch codex [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used.
• --api-url TEXT: Override the MeshAgent API URL for this Codex launch.
• --help: Show this message and exit.

​

meshagent launch claude

$ meshagent launch claude [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used.
• --api-url TEXT: Override the MeshAgent API URL for this Claude launch.
• --help: Show this message and exit.

​

meshagent token

$ meshagent token [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -o, --output TEXT: File path to a file
• -i, --input TEXT: File path to a token spec [required]
• --key TEXT: an api key to sign the token with
• --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.

​

meshagent webhook

$ meshagent webhook [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a webhook
• list: List webhooks
• delete: Delete a webhook

​

meshagent webhook create

$ meshagent webhook create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Friendly name for the webhook [required]
• --url TEXT: Target URL that will receive POSTs [required]
• -e, --event TEXT: Event to subscribe to (repeat for multiple). [required]
• TEXT: Optional description
• --action TEXT: Optional action name delivered with each call
• --payload TEXT: Optional JSON string sent as the body (merged with event payload).
• --help: Show this message and exit.

​

meshagent webhook list

$ meshagent webhook list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent webhook delete

$ meshagent webhook delete [OPTIONS] WEBHOOK_ID

• WEBHOOK_ID: ID of the webhook to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent service

$ meshagent service [OPTIONS] COMMAND [ARGS]...

• --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.

• spec: Render a service or template YAML spec…
• create: Create a service attached to the project.
• update: Create a service attached to the project.
• validate: Validate a service spec from a YAML file.
• create-template: Create a service from a ServiceTemplate spec.
• update-template: Update a service using a ServiceTemplate…
• validate-template: Validate a service template from a YAML file.
• render-template: Render a service template with variables…
• run: Run a local command and register it as a…
• show: Show a services for the project.
• list: List all services for the project.
• delete: Delete a service.

​

meshagent service spec

$ meshagent service spec [OPTIONS]

• -f, --file TEXT: File path to a service definition. Beginner fallback: point this at a meshagent.yaml when the app has no Dockerfile. For a public HTTP route, set container.private: false and metadata.annotations.meshagent.service.id in the file.
• --url TEXT: URL to a service definition
• --mcp TEXT: MCP server URL. Auto-discovers metadata and generates a service spec without creating it.
• --format [service|template]: Output format. ‘service’ emits Service YAML. ‘template’ emits ServiceTemplate YAML. [default: service]
• --service-id TEXT: Optional override for meshagent.service.id in metadata annotations.
• --help: Show this message and exit.

​

meshagent service create

$ meshagent service create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -f, --file TEXT: File path to a service definition
• --url TEXT: URL to a service definition
• --mcp TEXT: MCP server URL. Auto-discovers OAuth metadata and creates an external MCP service configured for dynamic client registration.
• --room TEXT: Room name
• --global: Create the service globally instead of in a room
• --service-id TEXT: Optional override for meshagent.service.id in metadata annotations.
• --force: Ignore an existing service with the same meshagent.service.id.
• --replace: Replace an existing service with the same meshagent.service.id.
• --help: Show this message and exit.

​

meshagent service update

$ meshagent service update [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --id TEXT
• -f, --file TEXT: File path to a service definition
• --url TEXT: URL to a service definition
• --mcp TEXT: MCP server URL. Auto-discovers OAuth metadata and builds an external MCP service configured for dynamic client registration.
• --create / --no-create: create the service if it does not exist [default: no-create]
• --room TEXT: Room name
• --global: Update the global service instead of a room service
• --service-id TEXT: Optional override for meshagent.service.id in metadata annotations.
• --force: Ignore an existing service with the same meshagent.service.id.
• --replace: Replace an existing service with the same meshagent.service.id.
• --help: Show this message and exit.

​

meshagent service validate

$ meshagent service validate [OPTIONS]

• -f, --file TEXT: File path to a service definition [required]
• --help: Show this message and exit.

​

meshagent service create-template

$ meshagent service create-template [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -f, --file TEXT: File path to a service template
• --url TEXT: URL to a service template
• --values-file TEXT: File path to template values
• -v, --value TEXT: Template value override (key=value)
• --room TEXT: Room name
• --global: Create the service globally instead of in a room
• --force: Ignore an existing service with the same meshagent.service.id.
• --replace: Replace an existing service with the same meshagent.service.id.
• --help: Show this message and exit.

​

meshagent service update-template

$ meshagent service update-template [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --id TEXT
• -f, --file TEXT: File path to a service template
• --url TEXT: URL to a service template
• --values-file TEXT: File path to template values
• -v, --value TEXT: Template value override (key=value)
• --create / --no-create: create the service if it does not exist [default: no-create]
• --room TEXT: Room name
• --global: Update the global service instead of a room service
• --force: Ignore an existing service with the same meshagent.service.id.
• --replace: Replace an existing service with the same meshagent.service.id.
• --help: Show this message and exit.

​

meshagent service validate-template

$ meshagent service validate-template [OPTIONS]

• -f, --file TEXT: File path to a service template
• --url TEXT: URL to a service template
• --values-file TEXT: File path to template values
• -v, --value TEXT: Template value override (key=value)
• --help: Show this message and exit.

​

meshagent service render-template

$ meshagent service render-template [OPTIONS]

• -f, --file TEXT: File path to a service template
• --url TEXT: URL to a service template
• --values-file TEXT: File path to template values
• -v, --value TEXT: Template value override (key=value)
• --help: Show this message and exit.

​

meshagent service run

$ meshagent service run [OPTIONS] COMMAND

• COMMAND: [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -p, --port INTEGER: a port number to run the agent on (will set MESHAGENT_PORT environment variable when launching the service)
• --room TEXT: Room name
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

​

meshagent service show

$ meshagent service show [OPTIONS] SERVICE_ID

• SERVICE_ID: ID of the service to show [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name
• --help: Show this message and exit.

​

meshagent service list

$ meshagent service list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -o, --output TEXT: output format [default: table]
• --room TEXT: Room name
• --help: Show this message and exit.

​

meshagent service delete

$ meshagent service delete [OPTIONS] SERVICE_ID

• SERVICE_ID: ID of the service to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name
• --help: Show this message and exit.

​

meshagent mcp

$ meshagent mcp [OPTIONS] COMMAND [ARGS]...

• --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.

• sse: Connect an MCP server over SSE and…
• http: Connect an MCP server over streamable HTTP…
• stdio: Run an MCP server over stdio and register…
• http-proxy: Expose a stdio MCP server over streamable…
• sse-proxy: Expose a stdio MCP server over SSE
• stdio-service: Run a stdio MCP server as an HTTP service

​

meshagent mcp sse

$ meshagent mcp sse [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --name TEXT: Participant name [default: cli]
• --role TEXT: [default: tool]
• --url TEXT: SSE URL for the MCP server [required]
• -H, --header TEXT: Request header (KEY:VALUE). Repeat for multiple headers
• --header-secret TEXT: Header from secret (HEADER:FORMAT). FORMAT uses secret placeholders, e.g. Header:Bearer {my_secret}
• --toolkit-name TEXT: Toolkit name to register in the room (default: mcp)
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

​

meshagent mcp http

$ meshagent mcp http [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --name TEXT: Participant name [default: cli]
• --role TEXT: [default: tool]
• --url TEXT: Streamable HTTP URL for the MCP server [required]
• -H, --header TEXT: Request header (KEY:VALUE). Repeat for multiple headers
• --header-secret TEXT: Header from secret (HEADER:FORMAT). FORMAT uses secret placeholders, e.g. Header:Bearer {my_secret}
• --toolkit-name TEXT: Toolkit name to register in the room (default: mcp)
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

​

meshagent mcp stdio

$ meshagent mcp stdio [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --name TEXT: Participant name [default: cli]
• --role TEXT: [default: tool]
• --command TEXT: Command to start an MCP server over stdio (quoted string) [required]
• --toolkit-name TEXT: Toolkit name to register in the room (default: mcp)
• -e, --env TEXT: KEY=VALUE
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

​

meshagent mcp http-proxy

$ meshagent mcp http-proxy [OPTIONS]

• --command TEXT: Command to start the MCP server (stdio transport) [required]
• --host TEXT: Host to bind the proxy server on
• --port INTEGER: Port to bind the proxy server on
• --path TEXT: HTTP path to mount the proxy server at
• --name TEXT: Display name for the proxy server
• -e, --env TEXT: KEY=VALUE
• --help: Show this message and exit.

​

meshagent mcp sse-proxy

$ meshagent mcp sse-proxy [OPTIONS]

• --command TEXT: Command to start the MCP server (stdio transport) [required]
• --host TEXT: Host to bind the proxy server on
• --port INTEGER: Port to bind the proxy server on
• --path TEXT: SSE path to mount the proxy at
• --name TEXT: Display name for the proxy server
• -e, --env TEXT: KEY=VALUE
• --help: Show this message and exit.

​

meshagent mcp stdio-service

$ meshagent mcp stdio-service [OPTIONS]

• --command TEXT: Command to start an MCP server over stdio (quoted string) [required]
• --host TEXT: Host to bind the service on
• --port INTEGER: Port to bind the service on
• --webhook-secret TEXT: Optional webhook secret for authenticating requests
• --path TEXT: HTTP path to mount the service at
• --toolkit-name TEXT: Toolkit name to expose (default: mcp)
• -e, --env TEXT: KEY=VALUE
• --help: Show this message and exit.

​

meshagent secret

$ meshagent secret [OPTIONS] COMMAND [ARGS]...

• --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.

• key: Create or update environment-based…
• docker: Create or update a Docker registry pull…
• acr: Create or update an Azure Container…
• gar: Create or update a Google Artifact…
• list: List all secrets in the project (typed as…
• delete: Delete a secret.

​

meshagent secret key

$ meshagent secret key [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a new ‘keys’ secret (opaque env-vars).
• update: Update an existing ‘keys’ secret (opaque…

​

meshagent secret key create

$ meshagent secret key create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Secret name [required]
• --data TEXT: Format: key=value key2=value (space-separated) [required]
• --help: Show this message and exit.

​

meshagent secret key update

$ meshagent secret key update [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --secret-id TEXT: Existing secret ID [required]
• --name TEXT: Secret name [required]
• --data TEXT: Format: key=value key2=value (space-separated) [required]
• --help: Show this message and exit.

​

meshagent secret docker

$ meshagent secret docker [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a new Docker pull secret (generic).
• update: Update an existing Docker pull secret…

​

meshagent secret docker create

$ meshagent secret docker create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Secret name [required]
• --server TEXT: Docker registry server, e.g. index.docker.io [required]
• --username TEXT: Registry user name [required]
• --password TEXT: Registry password [required]
• --email TEXT: User email for Docker config
• --help: Show this message and exit.

​

meshagent secret docker update

$ meshagent secret docker update [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --secret-id TEXT: Existing secret ID [required]
• --name TEXT: Secret name [required]
• --server TEXT: Docker registry server [required]
• --username TEXT: Registry user name [required]
• --password TEXT: Registry password [required]
• --email TEXT: User email for Docker config
• --help: Show this message and exit.

​

meshagent secret acr

$ meshagent secret acr [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a new ACR pull secret (defaults…
• update: Update an existing ACR pull secret…

​

meshagent secret acr create

$ meshagent secret acr create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Secret name [required]
• --server TEXT: ACR server, e.g. myregistry.azurecr.io [required]
• --username TEXT: Service principal ID [required]
• --password TEXT: Service principal secret/password [required]
• --help: Show this message and exit.

​

meshagent secret acr update

$ meshagent secret acr update [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --secret-id TEXT: Existing secret ID [required]
• --name TEXT: Secret name [required]
• --server TEXT: ACR server, e.g. myregistry.azurecr.io [required]
• --username TEXT: Service principal ID [required]
• --password TEXT: Service principal secret/password [required]
• --help: Show this message and exit.

​

meshagent secret gar

$ meshagent secret gar [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a new Google Artifact Registry pull…
• update: Update an existing Google Artifact…

​

meshagent secret gar create

$ meshagent secret gar create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Secret name [required]
• --server TEXT: GAR host, e.g. us-west1-docker.pkg.dev [required]
• --json-key TEXT: Entire GCP service account JSON as string [required]
• --help: Show this message and exit.

​

meshagent secret gar update

$ meshagent secret gar update [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --secret-id TEXT: Existing secret ID [required]
• --name TEXT: Secret name [required]
• --server TEXT: GAR host, e.g. us-west1-docker.pkg.dev [required]
• --json-key TEXT: Entire GCP service account JSON as string [required]
• --help: Show this message and exit.

​

meshagent secret list

$ meshagent secret list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent secret delete

$ meshagent secret delete [OPTIONS] SECRET_ID

• SECRET_ID: ID of the secret to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent rooms

$ meshagent rooms [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a room in the project.
• delete: Delete a room by ID (or by name if —name…
• update: Update a room’s name (ID is preferred;…
• list: List rooms in the project.
• get: Get a single room by name (handy for…

​

meshagent rooms create

$ meshagent rooms create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Room name [required]
• --if-not-exists / --no-if-not-exists: Do not error if the room already exists [default: no-if-not-exists]
• --metadata TEXT: Optional JSON object for room metadata
• --annotations TEXT: Optional JSON object for room annotations, e.g. {“meshagent.storage.class”:“ephemeral”}
• --help: Show this message and exit.

​

meshagent rooms delete

$ meshagent rooms delete [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --id TEXT: Room ID (preferred)
• --name TEXT
• --help: Show this message and exit.

​

meshagent rooms update

$ meshagent rooms update [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --id TEXT: Room ID (preferred)
• --name TEXT
• --new-name TEXT: New room name [required]
• --annotations TEXT: Optional JSON object for room annotations, e.g. {“meshagent.storage.class”:“ephemeral”}
• --help: Show this message and exit.

​

meshagent rooms list

$ meshagent rooms list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -o, --output TEXT: output format [default: table]
• --count INTEGER RANGE: Max rooms to return [default: 100; 1<=x<=500]
• --offset INTEGER RANGE: Offset for pagination [default: 0; x>=0]
• --order-by TEXT: Order by column (e.g. “room_name”, “created_at”) [default: room_name]
• --filter TEXT: Lowercase contains filter for room names
• --help: Show this message and exit.

​

meshagent rooms get

$ meshagent rooms get [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT
• --help: Show this message and exit.

​

meshagent mailbox

$ meshagent mailbox [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a mailbox attached to the project.
• update: Update a mailbox routing configuration.
• show: Show mailbox details.
• list: List mailboxes for the project.
• delete: Delete a mailbox.

​

meshagent mailbox create

$ meshagent mailbox create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -a, --address TEXT: Mailbox email address (unique per project) [required]
• --room TEXT: Room name
• -q, --queue TEXT: Queue name to deliver inbound messages to [required]
• --public: Queue name to deliver inbound messages to
• -n, --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent mailbox update

$ meshagent mailbox update [OPTIONS] ADDRESS

• ADDRESS: Mailbox email address to update [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -r, --room TEXT: Room name to route inbound mail into
• -q, --queue TEXT: Queue name to deliver inbound messages to
• --public: Queue name to deliver inbound messages to
• -n, --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent mailbox show

$ meshagent mailbox show [OPTIONS] ADDRESS

• ADDRESS: Mailbox address to show [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent mailbox list

$ meshagent mailbox list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name
• --filter TEXT: Lowercase contains filter
• --count INTEGER: Maximum number of mailboxes to return [default: 100]
• --offset INTEGER: Row offset for pagination [default: 0]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent mailbox delete

$ meshagent mailbox delete [OPTIONS] ADDRESS

• ADDRESS: Mailbox address to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent feed

$ meshagent feed [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a feed.
• update: Update a feed.
• show: Show feed details.
• list: List feeds for the project.
• delete: Delete a feed.
• send: Publish a single JSON message to a feed.
• send-batch: Publish a JSONL file to a feed.

​

meshagent feed create

$ meshagent feed create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -n, --name TEXT: Feed name [required]
• -d, --description TEXT: Feed description
• --visibility TEXT: Feed visibility [default: private]
• --paused: Create the feed in a paused state
• --annotations TEXT: annotations in json format {“name”:“value”}
• --message-schema TEXT: JSON schema as inline JSON
• --message-schema-file PATH: Path to a JSON schema file
• --help: Show this message and exit.

​

meshagent feed update

$ meshagent feed update [OPTIONS] FEED_ID

• FEED_ID: Feed id to update [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -n, --name TEXT: Feed name
• -d, --description TEXT: Feed description
• --paused: Pause the feed
• --resume: Resume a paused feed
• --annotations TEXT: annotations in json format {“name”:“value”}
• --message-schema TEXT: JSON schema as inline JSON
• --message-schema-file PATH: Path to a JSON schema file
• --clear-message-schema: Remove the existing message schema
• --help: Show this message and exit.

​

meshagent feed show

$ meshagent feed show [OPTIONS] FEED_ID

• FEED_ID: Feed id to show [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent feed list

$ meshagent feed list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name to filter feeds by
• --filter TEXT: Lowercase contains filter
• --count INTEGER: Maximum number of feeds to return [default: 100]
• --offset INTEGER: Row offset for pagination [default: 0]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent feed delete

$ meshagent feed delete [OPTIONS] FEED_ID

• FEED_ID: Feed id to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent feed send

$ meshagent feed send [OPTIONS] FEED_ID

• FEED_ID: Feed id to publish to [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --message TEXT: Inline JSON message
• --message-file PATH: Path to a JSON file
• --help: Show this message and exit.

​

meshagent feed send-batch

$ meshagent feed send-batch [OPTIONS] FEED_ID

• FEED_ID: Feed id to publish to [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --jsonl-file PATH: Path to a JSONL file [required]
• --help: Show this message and exit.

​

meshagent subscription

$ meshagent subscription [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a feed subscription.
• update: Update a feed subscription.
• show: Show feed subscription details.
• list: List subscriptions for a feed.
• delete: Delete a feed subscription.

​

meshagent subscription create

$ meshagent subscription create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --feed-id TEXT: Feed id [required]
• --room TEXT: Room name [required]
• --path TEXT: Storage path prefix [required]
• --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent subscription update

$ meshagent subscription update [OPTIONS] SUBSCRIPTION_ID

• SUBSCRIPTION_ID: Subscription id to update [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --feed-id TEXT: Feed id [required]
• --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent subscription show

$ meshagent subscription show [OPTIONS] SUBSCRIPTION_ID

• SUBSCRIPTION_ID: Subscription id to show [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --feed-id TEXT: Feed id [required]
• --help: Show this message and exit.

​

meshagent subscription list

$ meshagent subscription list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --feed-id TEXT: Feed id [required]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent subscription delete

$ meshagent subscription delete [OPTIONS] SUBSCRIPTION_ID

• SUBSCRIPTION_ID: Subscription id to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --feed-id TEXT: Feed id [required]
• --help: Show this message and exit.

​

meshagent route

$ meshagent route [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a route attached to the project.
• update: Update a route configuration.
• show: Show route details.
• list: List routes for the project.
• delete: Delete a route.

​

meshagent route create

$ meshagent route create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -d, --domain TEXT: Domain name to route (unique per project). Keep it short and DNS-safe; long room-name-derived domains may be rejected. [required]
• --room TEXT: Room name
• -p, --port TEXT: Published port to route to [required]
• -n, --annotations TEXT: annotations in json format {“name”:“value”}. When routing to a room service, include meshagent.service.id.
• --help: Show this message and exit.

​

meshagent route update

$ meshagent route update [OPTIONS] DOMAIN

• DOMAIN: Domain name to update [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -r, --room TEXT: Room name to route traffic into
• -p, --port TEXT: Published port to route to
• -n, --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent route show

$ meshagent route show [OPTIONS] DOMAIN

• DOMAIN: Domain name to show [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent route list

$ meshagent route list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name
• --filter TEXT: Lowercase contains filter
• --count INTEGER: Maximum number of routes to return [default: 100]
• --offset INTEGER: Row offset for pagination [default: 0]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent route delete

$ meshagent route delete [OPTIONS] DOMAIN

• DOMAIN: Domain name to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent registry

$ meshagent registry [OPTIONS] COMMAND [ARGS]...

• --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.

• create: Create a project registry repository.
• update: Update a project registry repository.
• show: Show registry details.
• list: List registries for the project.
• delete: Delete a project registry repository by id…

​

meshagent registry create

$ meshagent registry create [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -n, --name TEXT: Repository path in the public registry, for example ‘apps/demo’ [required]
• -d, --description TEXT: Human-readable description
• -a, --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent registry update

$ meshagent registry update [OPTIONS] REPOSITORY_ID

• REPOSITORY_ID: Repository id to update [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -n, --name TEXT: Updated repository path
• -d, --description TEXT: Updated description
• -a, --annotations TEXT: annotations in json format {“name”:“value”}
• --help: Show this message and exit.

​

meshagent registry show

$ meshagent registry show [OPTIONS] REPOSITORY_ID

• REPOSITORY_ID: Repository id to show [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent registry list

$ meshagent registry list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent registry delete

$ meshagent registry delete [OPTIONS] [REPOSITORY]

• [REPOSITORY]: Repository id or name to delete

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --name TEXT: Repository name to delete
• --help: Show this message and exit.

​

meshagent build

$ meshagent build [OPTIONS] PATH

• PATH: Local directory to stream as the build context. Format ‘<path>[:<mount>]’. Defaults mount to /context. [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used.
• --room TEXT: Existing room name.
• --tag TEXT: Image tag to build. Supports <repository>:<tag>, <project-key>/<repository>:<tag>, or <registry>/<project-key>/<repository>:<tag>. Shorthand forms resolve against the configured MeshAgent registry. [required]
• --context-path TEXT: Build context path inside the streamed build context (absolute path). Defaults to the PATH mount path.
• --dockerfile-path TEXT: Optional Dockerfile path inside the streamed build context (absolute path).
• --builder-name TEXT: Optional reusable builder name for streamed local builds.
• --private / --public: Whether the build container is private to the participant [default: public]
• --optimize / --no-optimize: Whether to optimize room image outputs to eStargz before publishing. Enabled by default. [default: optimize]
• --cred TEXT: Docker creds (username,password) or (registry,username,password)
• --help: Show this message and exit.

​

meshagent deploy

$ meshagent deploy [OPTIONS] [PATH]

• [PATH]: Local directory to stream as the build context before deploy. Format ‘<path>[:<mount>]’. Defaults mount to /context. PATH is typically the app directory you want to deploy.

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used.
• --room TEXT: Existing room name.
• --tag TEXT: Image tag to deploy, e.g. repo/name:tag. When used with PATH, shorthand <repository>:<tag> and <project-key>/<repository>:<tag> resolve against the configured MeshAgent registry. [required]
• --context-path TEXT: Build context path inside the packed build context (absolute path). Only used with PATH.
• --dockerfile-path TEXT: Optional Dockerfile path inside the packed build context (absolute path). Only used with PATH. Use this when the app directory has no top-level Dockerfile or when you create the Dockerfile under a different path.
• --optimize / --no-optimize: Whether to optimize room image outputs to eStargz during the build stage. Enabled by default. Only used with PATH. [default: optimize]
• --cred TEXT: Docker creds (username,password) or (registry,username,password)
• --builder-name TEXT: Optional reusable builder name for streamed local pack builds.
• --domain TEXT: Create or update a room route for the deployed service and return a public URL. Use this with —public when you need an external URL from deploy. Use ‘meshagent config get domains.pages’ to find the pages domain for —domain. Requires exactly one published service port.
• --liveness TEXT: HTTP path to use for service liveness checks. Defaults to / for new or missing HTTP liveness paths.
• --room-mount TEXT: Mount room storage as <source>:<mount>[:ro|rw]
• --project-mount TEXT: Mount project storage as <source>:<mount>[:ro|rw]
• --empty-dir-mount TEXT: Mount empty dir at <mount>[:ro|rw]
• --image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
• -e, --env TEXT: Set environment variable as KEY=VALUE
• --env-secret TEXT: Set environment variable from a room secret as NAME=SECRET_ID
• --identity TEXT: Identity name to use for —meshagent-token and —env-secret. Defaults to the current token identity or the derived service name.
• --meshagent-token TEXT: Inject MESHAGENT_TOKEN using userDefault, agentDefault, full, or a JSON ApiScope object.
• --private / --public: Whether published service ports should stay private or be public when they are created or updated. Defaults to private. [default: private]
• --wait / --no-wait: Wait for the deployed service to start, stream container logs, and verify the route liveness URL when —domain is provided. [default: wait]
• --help: Show this message and exit.

​

meshagent scheduled-task

$ meshagent scheduled-task [OPTIONS] COMMAND [ARGS]...

• --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.

• add: Add a scheduled task.
• list: List scheduled tasks.
• update: Update a scheduled task.
• runs: List runs for a scheduled task.
• delete: Delete a scheduled task.

​

meshagent scheduled-task add

$ meshagent scheduled-task add [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -r, --room TEXT: Room name
• -f, --file TEXT: Path to a ScheduledTaskSpec YAML file [required]
• --help: Show this message and exit.

​

meshagent scheduled-task list

$ meshagent scheduled-task list [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -r, --room TEXT: Filter by room name
• --id, --task-id TEXT: Filter by scheduled task id
• --active: Filter to active tasks only
• --inactive: Filter to inactive tasks only
• --filter TEXT: Lowercase contains filter
• --count INTEGER: Maximum number of tasks to return [default: 100]
• --offset INTEGER: Row offset for pagination [default: 0]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent scheduled-task update

$ meshagent scheduled-task update [OPTIONS] TASK_ID

• TASK_ID: Scheduled task id to update [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -f, --file TEXT: Path to a replacement ScheduledTaskSpec YAML file [required]
• --help: Show this message and exit.

​

meshagent scheduled-task runs

$ meshagent scheduled-task runs [OPTIONS] TASK_ID

• TASK_ID: Scheduled task id [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --count INTEGER: Maximum number of runs to return [default: 100]
• --offset INTEGER: Row offset for pagination [default: 0]
• -o, --output TEXT: output format [default: table]
• --help: Show this message and exit.

​

meshagent scheduled-task delete

$ meshagent scheduled-task delete [OPTIONS] TASK_ID

• TASK_ID: Scheduled task id to delete [required]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --help: Show this message and exit.

​

meshagent meeting-transcriber

$ meshagent meeting-transcriber [OPTIONS] COMMAND [ARGS]...

• --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.

• join: Join a room and run the meeting…
• service

​

meshagent meeting-transcriber join

$ meshagent meeting-transcriber join [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --agent-name TEXT: Name of the agent
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

​

meshagent meeting-transcriber service

$ meshagent meeting-transcriber service [OPTIONS]

• --agent-name TEXT: Name of the agent [required]
• --host TEXT: Host to bind the service on
• --port INTEGER: Port to bind the service on
• --path TEXT: HTTP path to mount the service at [default: /agent]
• --help: Show this message and exit.

​

meshagent port

$ meshagent port [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• -r, --room TEXT: Room name containing the target container [required]
• -n, --name TEXT: Container name to port-forward into
• -c, --container-id TEXT: Container ID to port-forward into
• -p, --port TEXT: Port mapping in the form LOCAL:REMOTE [required]
• --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.

​

meshagent voicebot

$ meshagent voicebot [OPTIONS] COMMAND [ARGS]...

• --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.

• join: Join a room and run a voicebot agent.
• service
• spec: Generate a service spec for deploying a…
• deploy: Deploy a voicebot service to a project or…

​

meshagent voicebot join

$ meshagent voicebot join [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --agent-name TEXT: Name of the agent to call
• --token-from-env TEXT: Name of environment variable containing a MeshAgent token
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -rs, --require-schema TEXT: the name or url of a required schema
• --auto-greet-message TEXT: Message to send automatically when the bot joins
• --auto-greet-prompt TEXT: Prompt to generate an auto-greet message
• --voice TEXT: OpenAI Realtime voice preset to use
• --key TEXT: an api key to sign the token with
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• --help: Show this message and exit.

​

meshagent voicebot service

$ meshagent voicebot service [OPTIONS]

• --agent-name TEXT: Name of the agent to call [required]
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -rs, --require-schema TEXT: the name or url of a required schema
• --auto-greet-message TEXT: Message to send automatically when the bot joins
• --auto-greet-prompt TEXT: Prompt to generate an auto-greet message
• --voice TEXT: OpenAI Realtime voice preset to use
• --host TEXT: Host to bind the service on
• --port INTEGER: Port to bind the service on
• --path TEXT: HTTP path to mount the service at
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• --help: Show this message and exit.

​

meshagent voicebot spec

$ meshagent voicebot spec [OPTIONS]

• --service-name TEXT: service name
• --service-description TEXT: service description
• --service-title TEXT: a display name for the service
• --agent-name TEXT: Name of the agent to call [required]
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -rs, --require-schema TEXT: the name or url of a required schema
• --auto-greet-message TEXT: Message to send automatically when the bot joins
• --auto-greet-prompt TEXT: Prompt to generate an auto-greet message
• --voice TEXT: OpenAI Realtime voice preset to use
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• --help: Show this message and exit.

​

meshagent voicebot deploy

$ meshagent voicebot deploy [OPTIONS]

• --service-name TEXT: service name
• --service-description TEXT: service description
• --service-title TEXT: a display name for the service
• --agent-name TEXT: Name of the agent to call [required]
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -rs, --require-schema TEXT: the name or url of a required schema
• --auto-greet-message TEXT: Message to send automatically when the bot joins
• --auto-greet-prompt TEXT: Prompt to generate an auto-greet message
• --voice TEXT: OpenAI Realtime voice preset to use
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: The name of a room to create the service for
• --help: Show this message and exit.

​

meshagent process

$ meshagent process [OPTIONS] COMMAND [ARGS]...

• --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.

• join: Join a room and run a process-backed agent.
• service: Add a process-backed agent service to the…
• spec: Generate a service spec for deploying a…
• deploy: Deploy a process-backed agent service.
• run: Join a room, run a process-backed agent,…
• use: Send a one-shot or interactive message to…

​

meshagent process join

$ meshagent process join [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: agent]
• --agent-name TEXT: Name of the agent to call
• --token-from-env TEXT: Name of environment variable containing a MeshAgent token
• -r, --rule TEXT: a system rule
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• --rules-file TEXT
• --instructions TEXT: a path in the configured storage toolkit to a rules file that will be loaded at runtime
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -s, --schema TEXT: the name or url of a required schema
• --model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.5]
• --image-generation TEXT: Name of an image gen model
• --computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
• --shell / --no-shell: Enable function shell tool calling [default: no-shell]
• --apply-patch / --no-apply-patch: Enable apply patch tool [default: no-apply-patch]
• --web-search / --no-web-search: Enable web search tool calling [default: no-web-search]
• --web-fetch / --no-web-fetch: Enable web fetch tool calling [default: no-web-fetch]
• --script-tool / --no-script-tool: Enable script tool calling [default: no-script-tool]
• --discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
• --mcp / --no-mcp: Enable mcp tool calling [default: no-mcp]
• --storage / --no-storage: Enable storage toolkit [default: no-storage]
• --storage-tool-local-path TEXT: Mount local path as <source>:<mount>[:ro|rw]
• --storage-tool-room-path TEXT: Mount room path as <source>:<mount>[:ro|rw]
• --shell-room-mount TEXT: Mount room storage as <source>:<mount>[:ro|rw]
• --shell-project-mount TEXT: Mount project storage as <source>:<mount>[:ro|rw]
• --shell-empty-dir-mount TEXT: Mount empty dir at <mount>[:ro|rw]
• --shell-tool-config-mount TEXT: Mount meshagent runtime config files read-only into <mount>
• --shell-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
• --starting-url TEXT: Initial URL to open when starting a computer-use browser session
• --allow-goto-url: Expose the goto URL helper tool for computer use
• --advanced-shell: Enable the managed container toolkit with start/list/stop/run tools.
• --dataset-namespace TEXT: Use a specific dataset namespace
• --table-read TEXT: Enable table read tools for a specific table
• --table-write TEXT: Enable table write tools for a specific table
• --read-only-storage: Enable read only storage toolkit
• --time: Enable time/datetime tools [default: True]
• --uuid: Enable UUID generation tools
• --use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
• --memory-model TEXT: Model name for memory LLM ingestion
• --document-authoring: Enable MeshDocument authoring
• --discovery: Enable discovery of agents and tools
• --working-dir TEXT: The default working directory for shell commands
• --key TEXT: an api key to sign the token with
• --llm-participant TEXT: Delegate LLM interactions to a remote participant
• --decision-model TEXT: Model used for thread naming and other secondary LLM decisions
• --host TEXT: Host to bind the service on
• --port INTEGER: Port to bind the service on
• --path TEXT: HTTP path to mount the service at
• --always-reply / --no-always-reply: Always reply
• --threading-mode [none|default-new]: Threading mode for thread UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
• --thread-dir TEXT: Thread directory for agent thread files. Defaults to .threads/<agent-name> when not provided.
• --channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
• --skill-dir TEXT: an agent skills directory
• --shell-image TEXT: an image tag to use to run shell commands in
• --delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
• --shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
• --shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
• --log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
• --help: Show this message and exit.

​

meshagent process service

$ meshagent process service [OPTIONS]

• --agent-name TEXT: Name of the agent to call [required]
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• --instructions TEXT: a path in the configured storage toolkit to a rules file that will be loaded at runtime
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -s, --schema TEXT: the name or url of a required schema
• --model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.5]
• --image-generation TEXT: Name of an image gen model
• --shell / --no-shell: Enable function shell tool calling [default: no-shell]
• --apply-patch / --no-apply-patch: Enable apply patch tool [default: no-apply-patch]
• --computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
• --web-search / --no-web-search: Enable web search tool calling [default: no-web-search]
• --web-fetch / --no-web-fetch: Enable web fetch tool calling [default: no-web-fetch]
• --script-tool / --no-script-tool: Enable script tool calling [default: no-script-tool]
• --discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
• --mcp / --no-mcp: Enable mcp tool calling [default: no-mcp]
• --storage / --no-storage: Enable storage toolkit [default: no-storage]
• --storage-tool-local-path TEXT: Mount local path as <source>:<mount>[:ro|rw]
• --storage-tool-room-path TEXT: Mount room path as <source>:<mount>[:ro|rw]
• --shell-room-mount TEXT: Mount room storage as <source>:<mount>[:ro|rw]
• --shell-project-mount TEXT: Mount project storage as <source>:<mount>[:ro|rw]
• --shell-empty-dir-mount TEXT: Mount empty dir at <mount>[:ro|rw]
• --shell-tool-config-mount TEXT: Mount meshagent runtime config files read-only into <mount>
• --shell-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
• --starting-url TEXT: Initial URL to open when starting a computer-use browser session
• --allow-goto-url: Expose the goto URL helper tool for computer use
• --advanced-shell: Enable the managed container toolkit with start/list/stop/run tools.
• --dataset-namespace TEXT: Use a specific dataset namespace
• --table-read TEXT: Enable table read tools for a specific table
• --table-write TEXT: Enable table write tools for a specific table
• --read-only-storage: Enable read only storage toolkit
• --time: Enable time/datetime tools [default: True]
• --uuid: Enable UUID generation tools
• --use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
• --memory-model TEXT: Model name for memory LLM ingestion
• --working-dir TEXT: The default working directory for shell commands
• --require-document-authoring / --no-require-document-authoring: Enable document authoring [default: no-require-document-authoring]
• --discovery: Enable discovery of agents and tools
• --llm-participant TEXT: Delegate LLM interactions to a remote participant
• --decision-model TEXT: Model used for thread naming and other secondary LLM decisions
• --host TEXT: Host to bind the service on
• --port INTEGER: Port to bind the service on
• --path TEXT: HTTP path to mount the service at
• --always-reply / --no-always-reply: Always reply
• --threading-mode [none|default-new]: Threading mode for thread UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
• --thread-dir TEXT: Thread directory for agent thread files. Defaults to .threads/<agent-name> when not provided.
• --channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
• --skill-dir TEXT: an agent skills directory
• --shell-image TEXT: an image tag to use to run shell commands in
• --delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
• --shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
• --shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
• --log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
• --help: Show this message and exit.

​

meshagent process spec

$ meshagent process spec [OPTIONS]

• --service-name TEXT: service name
• --service-description TEXT: service description
• --service-title TEXT: a display name for the service
• --agent-name TEXT: Name of the agent to call [required]
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• --instructions TEXT: a path in the configured storage toolkit to a rules file that will be loaded at runtime
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -s, --schema TEXT: the name or url of a required schema
• --model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.5]
• --image-generation TEXT: Name of an image gen model
• --shell / --no-shell: Enable function shell tool calling [default: no-shell]
• --apply-patch / --no-apply-patch: Enable apply patch tool [default: no-apply-patch]
• --computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
• --web-search / --no-web-search: Enable web search tool calling [default: no-web-search]
• --web-fetch / --no-web-fetch: Enable web fetch tool calling [default: no-web-fetch]
• --script-tool / --no-script-tool: Enable script tool calling [default: no-script-tool]
• --discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
• --mcp / --no-mcp: Enable mcp tool calling [default: no-mcp]
• --storage / --no-storage: Enable storage toolkit [default: no-storage]
• --storage-tool-local-path TEXT: Mount local path as <source>:<mount>[:ro|rw]
• --storage-tool-room-path TEXT: Mount room path as <source>:<mount>[:ro|rw]
• --shell-room-mount TEXT: Mount room storage as <source>:<mount>[:ro|rw]
• --shell-project-mount TEXT: Mount project storage as <source>:<mount>[:ro|rw]
• --shell-empty-dir-mount TEXT: Mount empty dir at <mount>[:ro|rw]
• --shell-tool-config-mount TEXT: Mount meshagent runtime config files read-only into <mount>
• --starting-url TEXT: Initial URL to open when starting a computer-use browser session
• --allow-goto-url: Expose the goto URL helper tool for computer use
• --advanced-shell: Enable the managed container toolkit with start/list/stop/run tools.
• --dataset-namespace TEXT: Use a specific dataset namespace
• --table-read TEXT: Enable table read tools for a specific table
• --table-write TEXT: Enable table write tools for a specific table
• --read-only-storage: Enable read only storage toolkit
• --time: Enable time/datetime tools [default: True]
• --uuid: Enable UUID generation tools
• --use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
• --memory-model TEXT: Model name for memory LLM ingestion
• --working-dir TEXT: The default working directory for shell commands
• --require-document-authoring / --no-require-document-authoring: Enable document authoring [default: no-require-document-authoring]
• --discovery: Enable discovery of agents and tools
• --llm-participant TEXT: Delegate LLM interactions to a remote participant
• --decision-model TEXT: Model used for thread naming and other secondary LLM decisions
• --always-reply / --no-always-reply: Always reply
• --threading-mode [none|default-new]: Threading mode for thread UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
• --thread-dir TEXT: Thread directory for agent thread files. Defaults to .threads/<agent-name> when not provided.
• --channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
• --skill-dir TEXT: an agent skills directory
• --shell-image TEXT: an image tag to use to run shell commands in
• --delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
• --shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
• --shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
• --log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
• --help: Show this message and exit.

​

meshagent process deploy

$ meshagent process deploy [OPTIONS]

• --service-name TEXT: service name
• --service-description TEXT: service description
• --service-title TEXT: a display name for the service
• --agent-name TEXT: Name of the agent to call [required]
• -r, --rule TEXT: a system rule
• --rules-file TEXT
• --instructions TEXT: a path in the configured storage toolkit to a rules file that will be loaded at runtime
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -s, --schema TEXT: the name or url of a required schema
• --model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.5]
• --image-generation TEXT: Name of an image gen model
• --shell / --no-shell: Enable function shell tool calling [default: no-shell]
• --apply-patch / --no-apply-patch: Enable apply patch tool [default: no-apply-patch]
• --computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
• --web-search / --no-web-search: Enable web search tool calling [default: no-web-search]
• --web-fetch / --no-web-fetch: Enable web fetch tool calling [default: no-web-fetch]
• --script-tool / --no-script-tool: Enable script tool calling [default: no-script-tool]
• --discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
• --mcp / --no-mcp: Enable mcp tool calling [default: no-mcp]
• --storage / --no-storage: Enable storage toolkit [default: no-storage]
• --storage-tool-local-path TEXT: Mount local path as <source>:<mount>[:ro|rw]
• --storage-tool-room-path TEXT: Mount room path as <source>:<mount>[:ro|rw]
• --shell-room-mount TEXT: Mount room storage as <source>:<mount>[:ro|rw]
• --shell-project-mount TEXT: Mount project storage as <source>:<mount>[:ro|rw]
• --shell-empty-dir-mount TEXT: Mount empty dir at <mount>[:ro|rw]
• --shell-tool-config-mount TEXT: Mount meshagent runtime config files read-only into <mount>
• --starting-url TEXT: Initial URL to open when starting a computer-use browser session
• --allow-goto-url: Expose the goto URL helper tool for computer use
• --advanced-shell: Enable the managed container toolkit with start/list/stop/run tools.
• --dataset-namespace TEXT: Use a specific dataset namespace
• --table-read TEXT: Enable table read tools for a specific table
• --table-write TEXT: Enable table write tools for a specific table
• --read-only-storage: Enable read only storage toolkit
• --time: Enable time/datetime tools [default: True]
• --uuid: Enable UUID generation tools
• --use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
• --memory-model TEXT: Model name for memory LLM ingestion
• --working-dir TEXT: The default working directory for shell commands
• --require-document-authoring / --no-require-document-authoring: Enable document authoring [default: no-require-document-authoring]
• --discovery: Enable discovery of agents and tools
• --llm-participant TEXT: Delegate LLM interactions to a remote participant
• --decision-model TEXT: Model used for thread naming and other secondary LLM decisions
• --always-reply / --no-always-reply: Always reply
• --threading-mode [none|default-new]: Threading mode for thread UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
• --thread-dir TEXT: Thread directory for agent thread files. Defaults to .threads/<agent-name> when not provided.
• --channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
• --skill-dir TEXT: an agent skills directory
• --shell-image TEXT: an image tag to use to run shell commands in
• --delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
• --shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
• --shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
• --log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: The name of a room to create the service for
• --help: Show this message and exit.

​

meshagent process run

$ meshagent process run [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: agent]
• --agent-name TEXT: Name of the agent to call
• -r, --rule TEXT: a system rule
• -rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
• --rules-file TEXT
• --instructions TEXT: a path in the configured storage toolkit to a rules file that will be loaded at runtime
• -rt, --require-toolkit TEXT: the name or url of a required toolkit
• -s, --schema TEXT: the name or url of a required schema
• --model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.5]
• --image-generation TEXT: Name of an image gen model
• --computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
• --shell / --no-shell: Enable function shell tool calling [default: no-shell]
• --apply-patch / --no-apply-patch: Enable apply patch tool [default: no-apply-patch]
• --web-search / --no-web-search: Enable web search tool calling [default: no-web-search]
• --web-fetch / --no-web-fetch: Enable web fetch tool calling [default: no-web-fetch]
• --script-tool / --no-script-tool: Enable script tool calling [default: no-script-tool]
• --discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
• --mcp / --no-mcp: Enable mcp tool calling [default: no-mcp]
• --storage / --no-storage: Enable storage toolkit [default: no-storage]
• --storage-tool-local-path TEXT: Mount local path as <source>:<mount>[:ro|rw]
• --storage-tool-room-path TEXT: Mount room path as <source>:<mount>[:ro|rw]
• --shell-room-mount TEXT: Mount room storage as <source>:<mount>[:ro|rw]
• --shell-project-mount TEXT: Mount project storage as <source>:<mount>[:ro|rw]
• --shell-empty-dir-mount TEXT: Mount empty dir at <mount>[:ro|rw]
• --shell-tool-config-mount TEXT: Mount meshagent runtime config files read-only into <mount>
• --starting-url TEXT: Initial URL to open when starting a computer-use browser session
• --allow-goto-url: Expose the goto URL helper tool for computer use
• --advanced-shell: Enable the managed container toolkit with start/list/stop/run tools.
• --dataset-namespace TEXT: Use a specific dataset namespace
• --table-read TEXT: Enable table read tools for a specific table
• --table-write TEXT: Enable table write tools for a specific table
• --read-only-storage: Enable read only storage toolkit
• --time: Enable time/datetime tools [default: True]
• --uuid: Enable UUID generation tools
• --use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
• --memory-model TEXT: Model name for memory LLM ingestion
• --document-authoring: Enable MeshDocument authoring
• --discovery: Enable discovery of agents and tools
• --working-dir TEXT: The default working directory for shell commands
• --key TEXT: an api key to sign the token with
• --llm-participant TEXT: Delegate LLM interactions to a remote participant
• --decision-model TEXT: Model used for thread naming and other secondary LLM decisions
• --always-reply / --no-always-reply: Always reply
• --threading-mode [none|default-new]: Threading mode for thread UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
• --thread-dir TEXT: Thread directory for agent thread files. Defaults to .threads/<agent-name> when not provided.
• --channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
• --skill-dir TEXT: an agent skills directory
• --shell-image TEXT: an image tag to use to run shell commands in
• --delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
• --shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
• --shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
• --log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
• --verbose: Enable verbose logging and disable default log suppression
• --thread-path TEXT: log all requests to the llm
• --message TEXT: the input message to use
• --use-web-search / --no-use-web-search: request the web search tool
• --use-image-gen / --no-use-image-gen: request the image gen tool
• --use-storage / --no-use-storage: request the storage tool
• --help: Show this message and exit.

​

meshagent process use

$ meshagent process use [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --agent-name TEXT: Name of the agent to call
• --thread-path TEXT: log all requests to the llm
• --message TEXT: the input message to use
• --help: Show this message and exit.

​

meshagent room

$ meshagent room [OPTIONS] COMMAND [ARGS]...

• --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.

• agents: Interact with agents and toolkits in a room
• secret: Manage room-scoped secrets and OAuth flows
• queue: Use queues in a room
• messaging: Send and receive messages in a room
• storage: Manage storage for a room
• service: Manage services inside a room
• developer: Stream developer logs from a room
• dataset: Manage dataset tables in a room
• memory: Manage room memories
• container: Manage containers and images inside a room
• sync: Inspect and update mesh documents in a room
• connect: Connect to a room and run a local command…

​

meshagent room agents

$ meshagent room agents [OPTIONS] COMMAND [ARGS]...

• --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.

• call: Trigger agent/tool calls in a room
• invoke-tool: Invoke a specific tool from a toolkit
• list-toolkits: List toolkits (and tools) available in the…

​

meshagent room agents call

$ meshagent room agents call [OPTIONS] COMMAND [ARGS]...

• --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.

• tool: Send a call request to a tool webhook URL
• agent: Send a call request to an agent webhook URL
• toolkit: Send a call request to a toolkit webhook URL
• schema: Send a call request to a schema webhook URL

meshagent room agents call tool

$ meshagent room agents call tool [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: agent]
• --local / --no-local
• --participant-name TEXT: the participant name to be used by the callee
• --url TEXT: URL the agent should call [required]
• --arguments TEXT: JSON string with arguments for the call [default: {}]
• -p, --permissions TEXT: File path to a token definition, if not specified default agent permissions will be used
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

meshagent room agents call agent

$ meshagent room agents call agent [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: agent]
• --local / --no-local
• --participant-name TEXT: the participant name to be used by the callee
• --url TEXT: URL the agent should call [required]
• --arguments TEXT: JSON string with arguments for the call [default: {}]
• -p, --permissions TEXT: File path to a token definition, if not specified default agent permissions will be used
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

meshagent room agents call toolkit

$ meshagent room agents call toolkit [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: agent]
• --local / --no-local
• --participant-name TEXT: the participant name to be used by the callee
• --url TEXT: URL the agent should call [required]
• --arguments TEXT: JSON string with arguments for the call [default: {}]
• -p, --permissions TEXT: File path to a token definition, if not specified default agent permissions will be used
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

meshagent room agents call schema

$ meshagent room agents call schema [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: agent]
• --local / --no-local
• --participant-name TEXT: the participant name to be used by the callee
• --url TEXT: URL the agent should call [required]
• --arguments TEXT: JSON string with arguments for the call [default: {}]
• -p, --permissions TEXT: File path to a token definition, if not specified default agent permissions will be used
• --key TEXT: an api key to sign the token with
• --help: Show this message and exit.

​

meshagent room agents invoke-tool

$ meshagent room agents invoke-tool [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --toolkit TEXT: Toolkit name [required]
• --tool TEXT: Tool name [required]
• --arguments TEXT: JSON string with arguments for the tool [required]
• --participant-id TEXT: Optional participant ID to invoke the tool on
• --on-behalf-of-id TEXT: Optional ‘on_behalf_of’ participant ID
• --caller-context TEXT: Optional JSON for caller context
• --timeout INTEGER: How long to wait for the toolkit if the toolkit is not in the room [default: 30]
• --help: Show this message and exit.

​

meshagent room agents list-toolkits

$ meshagent room agents list-toolkits [OPTIONS]

• --project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]
• --room TEXT: Room name [default: (dynamic)]
• --role TEXT: [default: user]
• --participant-id TEXT: Optional participant ID
• --help: Show this message and exit.

​

meshagent room secret

$ meshagent room secret [OPTIONS] COMMAND [ARGS]...

• --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.

• oauth: Request an OAuth token from another…
• request: Request a secret from another participant.
• get: Fetch a stored secret by ID.
• exists: Check whether a stored secret exists by ID.
• set: Store a secret by ID.
• list: List secrets in the room.
• delete: Delete a secret by ID.

​

meshagent room secret oauth