meshagent
Usage:
--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 versionsetup: Perform initial login and project/api key…auth: Authenticate to meshagentproject: Manage or activate your meshagent projectsapi-key: Manage or activate api-keys for your projectconfig: Read MeshAgent deployment configurationdoctor: Inspect the current directory for…create: Create a minimal deployable project.session: Inspect recent sessions and eventsask: Send a one-shot LLM prompt.launch: Launch supported CLI apps through MeshAgent.token: Generate a participant token (JWT) from a…webhook: Manage project webhooksservice: Manage services for your projectmcp: Bridge MCP servers into MeshAgent roomssecret: Manage secrets for your project.rooms: Create, list, and manage rooms in a projectagent: Create, list, and manage managed agents in…mailbox: Manage mailboxes for your projectfeed: Manage feeds for your projectsubscription: Manage feed subscriptions for your projectroute: Manage routes for your projectregistry: Manage registries for your projectbuild: Build a container image inside a room.deploy: Create or update a room service from an…scheduled-task: Manage scheduled tasks for your projectmeeting-transcriber: Join a meeting transcriber to a roomport: Forward a container port to localhostvoicebot: Join a voicebot to a roomprocess: Run process-backed agentsroom: Operate within a roomllm: Local LLM proxy utilities
meshagent version
Print the version
Usage:
--help: Show this message and exit.
meshagent setup
Perform initial login and project/api key activation.
Usage:
--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
Authenticate to meshagent
Usage:
--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.
loginlogoutswitchwhoamitoken
meshagent auth login
Usage:
--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
Usage:
--help: Show this message and exit.
meshagent auth switch
Usage:
[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
Usage:
--help: Show this message and exit.
meshagent auth token
Usage:
--help: Show this message and exit.
meshagent project
Manage or activate your meshagent projects
Usage:
--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…get: Get a MeshAgent project.activate: Set the active project for subsequent CLI…
meshagent project create
Create a new MeshAgent project.
Usage:
NAME: [required]
--help: Show this message and exit.
meshagent project list
List projects and mark the currently active one.
Usage:
-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent project get
Get a MeshAgent project.
Usage:
PROJECT: Project id or key to get [required]
-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent project activate
Set the active project for subsequent CLI commands.
Usage:
[PROJECT_ID]: Project id or key. 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
Manage or activate api-keys for your project
Usage:
--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.get: Get 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
List API keys for a project.
Usage:
--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
Create a new API key for a project.
Usage:
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 get
Get the activated API key for a project.
Usage:
--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
Print the activated API key as a shell export snippet.
Usage:
--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
Set the default API key for a project in local CLI settings.
Usage:
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
Delete an API key from a project.
Usage:
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
Read MeshAgent deployment configuration
Usage:
--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
Print one deployment config value.
Usage:
PATH: Config path to read, for example domains.pages [required]
--help: Show this message and exit.
meshagent doctor
Inspect the current directory for MeshAgent deployment gaps.
Usage:
[PATH]
--fix: Create obvious missing project files such as Dockerfile or pyproject.toml.--help: Show this message and exit.
meshagent create
Create a minimal deployable project.
Usage:
[PATH]
-l, --language TEXT: Template language for non-interactive use. Supported: python, javascript, typescript, react, dotnet, dart/flutter.--focus TEXT: Project focus for non-interactive use. Use stable IDs: webserver (Web App), backend-agent (Agent Toolkit), chatbot (OpenAI Chatbot), chatbot-anthropic (Anthropic Chatbot), chatbot-ui (Agent UI), room-chat (Room Chat), room-workspace (Room Workspace), or contact-form (Contact Form).--interactive / --no-interactive: Run or bypass the interactive template picker. Defaults to interactive when attached to a TTY and language or focus is missing.--help: Show this message and exit.
meshagent session
Inspect recent sessions and events
Usage:
--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 sessionsget: Get events for a sessionlogs: List logs for a sessionmetrics: List metrics for a sessiontraces: List trace spans for a session as a tree
meshagent session list
List recent sessions
Usage:
--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 get
Get events for a session
Usage:
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 logs
List logs for a session
Usage:
[SESSION_ARG]: Session id to inspect
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--session-id TEXT: Session id to inspect--room TEXT: Use the most recent session for this room-o, --output TEXT: output format [default: table]--attrs: Include log and resource attributes--help: Show this message and exit.
meshagent session metrics
List metrics for a session
Usage:
[SESSION_ARG]: Session id to inspect
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--session-id TEXT: Session id to inspect--room TEXT: Use the most recent session for this room-o, --output TEXT: output format [default: table]--attrs: Include metric attributes--buckets: Include histogram bucket counts--help: Show this message and exit.
meshagent session traces
List trace spans for a session as a tree
Usage:
[SESSION_ARG]: Session id to inspect
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--session-id TEXT: Session id to inspect--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
Send a one-shot LLM prompt.
Usage:
--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: markdown]--model TEXT: Name of the LLM model to use [default: gpt-5.5]--preamble-rule / --no-preamble-rule: Include the default rule asking the model to send concise pre-tool preambles. [default: preamble-rule]--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
Launch supported CLI apps through MeshAgent.
Usage:
--help: Show this message and exit.
codex: Launch Codex through MeshAgent for the…claude: Launch Claude through MeshAgent for the…
meshagent launch codex
Launch Codex through MeshAgent for the active project.
Usage:
--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
Launch Claude through MeshAgent for the active project.
Usage:
--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
Generate a participant token (JWT) from a spec
Usage:
--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
Manage project webhooks
Usage:
--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 webhooklist: List webhooksget: Get a webhookdelete: Delete a webhook
meshagent webhook create
Create a webhook
Usage:
--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]-d, --description 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
List webhooks
Usage:
--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 get
Get a webhook
Usage:
WEBHOOK_ID: ID of the webhook to get [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 webhook delete
Delete a webhook
Usage:
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
Manage services for your project
Usage:
--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…get: Get a service for the project.list: List all services for the project.delete: Delete a service.
meshagent service spec
Render a service or template YAML spec without creating a service.
Usage:
-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
Create a service attached to the project.
Beginner fallback when an app does not have a Dockerfile: write a minimal
meshagent.yaml, set the HTTP port to published/public, set
container.private: false for a public route, and include
metadata.annotations.meshagent.service.id so a route can target the created
service.
Usage:
--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
Create a service attached to the project.
Usage:
--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
Validate a service spec from a YAML file.
Usage:
-f, --file TEXT: File path to a service definition [required]--help: Show this message and exit.
meshagent service create-template
Create a service from a ServiceTemplate spec.
Usage:
--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
Update a service using a ServiceTemplate spec.
Usage:
--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
Validate a service template from a YAML file.
Usage:
-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
Render a service template with variables and print the rendered YAML.
Usage:
-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
Run a local command and register it as a temporary room service.
Usage:
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 get
Get a service for the project.
Usage:
SERVICE_ID: Service UUID or metadata name to get [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
List all services for the project.
Usage:
--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
Delete a service.
Usage:
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
Bridge MCP servers into MeshAgent rooms
Usage:
--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 SSEstdio-service: Run a stdio MCP server as an HTTP service
meshagent mcp sse
Connect an MCP server over SSE and register it as a toolkit
Usage:
--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
Connect an MCP server over streamable HTTP and register it as a toolkit
Usage:
--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
Run an MCP server over stdio and register it as a toolkit
Usage:
--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
Expose a stdio MCP server over streamable HTTP
Usage:
--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
Expose a stdio MCP server over SSE
Usage:
--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
Run a stdio MCP server as an HTTP service
Usage:
--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
Manage secrets for your project.
Usage:
--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
Create or update environment-based key-value secrets.
Usage:
--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
Create a new ‘keys’ secret (opaque env-vars).
Usage:
--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
Update an existing ‘keys’ secret (opaque env-vars).
Usage:
--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
Create or update a Docker registry pull secret.
Usage:
--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
Create a new Docker pull secret (generic).
Usage:
--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
Update an existing Docker pull secret (generic).
Usage:
--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
Create or update an Azure Container Registry pull secret.
Usage:
--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
Create a new ACR pull secret (defaults email to ‘none@microsoft.com’).
Usage:
--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
Update an existing ACR pull secret (defaults email to ‘none@microsoft.com’).
Usage:
--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
Create or update a Google Artifact Registry pull secret.
Usage:
--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
Create a new Google Artifact Registry pull secret.
By default, sets email=‘none@google.com’, username=’_json_key’
Usage:
--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
Update an existing Google Artifact Registry pull secret.
Usage:
--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
List all secrets in the project (typed as Docker/ACR/GAR or Keys secrets).
Usage:
--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
Delete a secret.
Usage:
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
Create, list, and manage rooms in a project
Usage:
--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 or ID.
meshagent rooms create
Create a room in the project.
Usage:
[NAME]: Room name
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--owner / --no-owner: Add the active user as the room owner. [default: owner]--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
Delete a room by ID (or by name if —name is supplied).
Usage:
--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
Update a room’s name (ID is preferred; name will be resolved to ID if needed).
Usage:
--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
List rooms in the project.
Usage:
--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--all: Show all rooms in the project instead of only rooms you can access--help: Show this message and exit.
meshagent rooms get
Get a single room by name or ID.
Usage:
[ROOM]: Room name or ID
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--help: Show this message and exit.
meshagent agent
Create, list, and manage managed agents in a project
Usage:
--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.
secret: Manage secrets for a managed agentcreate: Create a managed agent in the project.delete: Delete a managed agent from the project.update: Update a managed agent configuration.list: List managed agents in the project.get: Get a managed agent configuration.use: Use a managed agent over its websocket…
meshagent agent secret
Manage secrets for a managed agent
Usage:
--help: Show this message and exit.
listgetsetdelete
meshagent agent secret list
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--id TEXT: Agent ID (preferred)--name TEXT: Agent name-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent agent secret get
Usage:
SECRET_ID: Secret ID [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--id TEXT: Agent ID (preferred)--name TEXT: Agent name-o, --output TEXT: output format [default: json]--help: Show this message and exit.
meshagent agent secret set
Usage:
SECRET_ID: Secret ID [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--id TEXT: Agent ID (preferred)--name TEXT: Agent name--secret-name TEXT: Display name--type TEXT: Secret content type [default: keys]--data TEXT: Secret data as a JSON object, for example ’{“OPENAI_API_KEY”:”…”}’ [required]--help: Show this message and exit.
meshagent agent secret delete
Usage:
SECRET_ID: Secret ID [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--id TEXT: Agent ID (preferred)--name TEXT: Agent name--help: Show this message and exit.
meshagent agent create
Create a managed agent in the project.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]-c, --configuration TEXT: ManagedAgentSpec JSON [required]--thread-isolation [global|participant]: Thread isolation mode for the managed agent--if-not-exists / --no-if-not-exists: Do not error if the agent already exists [default: no-if-not-exists]--help: Show this message and exit.
meshagent agent delete
Delete a managed agent from the project.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--id TEXT: Agent ID (preferred)--name TEXT: Agent name--help: Show this message and exit.
meshagent agent update
Update a managed agent configuration.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--id TEXT: Agent ID (preferred)--name TEXT: Current agent name-c, --configuration TEXT: ManagedAgentSpec JSON [required]--thread-isolation [global|participant]: Thread isolation mode for the managed agent--help: Show this message and exit.
meshagent agent list
List managed agents in the project.
Usage:
--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 agents 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. “agent_name”, “created_at”) [default: agent_name]--filter TEXT: Lowercase contains filter for agent names--help: Show this message and exit.
meshagent agent get
Get a managed agent configuration.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--name TEXT: Agent name [required]--help: Show this message and exit.
meshagent agent use
Use a managed agent over its websocket connection.
Usage:
[AGENT]: Agent name
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--name TEXT: Agent name--thread-id TEXT: Thread id to open--load: Replay persisted thread messages when opening--since-turn TEXT: Replay persisted thread messages starting with this turn id-m, --message TEXT: Send one message without opening the TUI-o, --output [text|json]: Output format for one-shot messages [default: text]--help: Show this message and exit.
meshagent mailbox
Manage mailboxes for your project
Usage:
--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.get: Get mailbox details.list: List mailboxes for the project.delete: Delete a mailbox.
meshagent mailbox create
Create a mailbox attached to the project.
Usage:
--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
Update a mailbox routing configuration.
Usage:
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 get
Get mailbox details.
Usage:
ADDRESS: Mailbox address to get [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
List mailboxes for the project.
Usage:
--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
Delete a mailbox.
Usage:
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
Manage feeds for your project
Usage:
--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.get: Get 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
Create a feed.
Usage:
--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
Update a feed.
Usage:
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 get
Get feed details.
Usage:
FEED_ID: Feed id to get [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
List feeds for the project.
Usage:
--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
Delete a feed.
Usage:
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
Publish a single JSON message to a feed.
Usage:
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
Publish a JSONL file to a feed.
Usage:
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
Manage feed subscriptions for your project
Usage:
--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.get: Get feed subscription details.list: List subscriptions for a feed.delete: Delete a feed subscription.
meshagent subscription create
Create a feed subscription.
Usage:
--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]--filename-datetime-format TEXT: GCP Cloud Storage filename datetime format. Use slashes to bucket files, for example YYYY/MM/DD/hh_mm_ssZ.--annotations TEXT: annotations in json format {“name”:“value”}--help: Show this message and exit.
meshagent subscription update
Update a feed subscription.
Usage:
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]--filename-datetime-format TEXT: GCP Cloud Storage filename datetime format. Pass an empty string to restore the default.--annotations TEXT: annotations in json format {“name”:“value”}--help: Show this message and exit.
meshagent subscription get
Get feed subscription details.
Usage:
SUBSCRIPTION_ID: Subscription id to get [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
List subscriptions for a feed.
Usage:
--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
Delete a feed subscription.
Usage:
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
Manage routes for your project
Usage:
--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.get: Get route details.list: List routes for the project.delete: Delete a route.
meshagent route create
Create a route attached to the project.
Use a short, DNS-safe domain name that matches the suffix accepted by your
environment. When routing to a room service, include the
meshagent.service.id annotation so the route targets the created service.
Usage:
--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.-f, --file TEXT: Path to a RouteSpec YAML or JSON file--room TEXT: Room name-p, --port TEXT: Published port to route to-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
Update a route configuration.
Usage:
DOMAIN: Domain name 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 RouteSpec YAML or JSON file-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 get
Get route details.
Usage:
DOMAIN: Domain name to get [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
List routes for the project.
Usage:
--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
Delete a route.
Usage:
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
Manage registries for your project
Usage:
--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.get: Get registry details.list: List registries for the project.delete: Delete a project registry repository by id…
meshagent registry create
Create a project registry repository.
Usage:
--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
Update a project registry repository.
Usage:
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 get
Get registry details.
Usage:
REPOSITORY_ID: Repository id to get [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
List registries for the project.
Usage:
--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
Delete a project registry repository by id or name.
Usage:
[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
Build a container image inside a room.
Usage:
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)--latest: Also publish the built image as :latest in the same repository.--help: Show this message and exit.
meshagent deploy
Create or update a room service from an image, optionally building it first. The target room must already exist. If .meshagent/deploy.yaml exists, deploy prompts for template values in TUI mode and saves them to .meshagent/values.yaml. Use meshagent deploy describe to inspect the local deploy spec. Happy path for a Dockerfile app: run ‘meshagent deploy PATH —room <room> —tag <tag> —public —domain <domain>’. Use ‘meshagent config get domains.pages’ to find the pages domain for —domain. If PATH does not include a Dockerfile yet, create a minimal Dockerfile in the app directory first or create one elsewhere in PATH and pass it with —dockerfile-path.
Usage:
[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.--latest: Also publish the built PATH image as :latest in the same repository. Only used with PATH.--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.--email TEXT: Create or update a public mailbox for the deployed service. When a local deploy template has an email variable, that value is used unless —email is passed.-f, --values TEXT: YAML file containing deploy template values. Can be passed multiple times; later files override earlier files.--set TEXT: Set a deploy template value as KEY=VALUE. Can be passed multiple times.--extra-port TEXT: Add an extra route path to DOMAIN as TARGET:/path. TARGET can be PORT, SERVICE, or SERVICE:PORT. Can be passed multiple times. The target must already be published by a room service.--validation-mode TEXT: Request validation annotation mode for private published service ports: default, cookie, or none. [default: default]--template TEXT: Allowed values: agent, none. agent: MeshAgent mounts room storage at /data, sets MESHAGENT_TOKEN, OPENAI_API_KEY, and ANTHROPIC_API_KEY to a container-scoped MeshAgent token. agent also sets SMTP_PASSWORD to that token, SMTP_USERNAME to the container name, SMTP_PORT to 587, SMTP_HOSTNAME from MESHAGENT_MAIL_DOMAIN when available, plus OPENAI_BASE_URL, ANTHROPIC_BASE_URL, MESHAGENT_API_URL, MESHAGENT_ROOM_URL, MESHAGENT_ROOM, MESHAGENT_PROJECT_ID, MESHAGENT_SESSION_ID, OTEL_ENDPOINT, OTEL_PYTHON_LOG_LEVEL, and MESHAGENT_MAIL_DOMAIN from the room runtime when available. Manual env values win. none: MeshAgent applies no template defaults. [default: agent]--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
Manage scheduled tasks for your project
Usage:
--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
Add a scheduled task.
Usage:
--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
List scheduled tasks.
Usage:
--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
Update a scheduled task.
Usage:
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
List runs for a scheduled task.
Usage:
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
Delete a scheduled task.
Usage:
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
Join a meeting transcriber to a room
Usage:
--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
Join a room and run the meeting transcriber agent.
Usage:
--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
Usage:
--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
Forward a container port to localhost
Usage:
--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
Join a voicebot to a room
Usage:
--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.servicespec: Generate a service spec for deploying a…deploy: Deploy a voicebot service to a project or…
meshagent voicebot join
Join a room and run a voicebot agent.
Usage:
--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
Usage:
--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
Generate a service spec for deploying a voicebot.
Usage:
--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
Deploy a voicebot service to a project or room.
Usage:
--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
Run process-backed agents
Usage:
--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: Run a process-backed agent and wait for…threads: List threads for a process-backed agent.messages: List messages in a process-backed agent…grep: Search coalesced messages in a…use: Send a one-shot or interactive message to…
meshagent process join
Join a room and run a process-backed agent.
Usage:
--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--preamble-rule / --no-preamble-rule: Include the default rule asking the model to send concise pre-tool preambles when no custom rules are configured. [default: preamble-rule]-rt, --require-toolkit TEXT: the name or url of a required toolkit--tool-search [room|agent|none]: Expose required toolkits through OpenAI Responses tool search. Use agent for statically configured non-OpenAI builtin tools, room for those plus annotated room toolkits, or none. [default: none]-s, --schema TEXT: the name or url of a required schema--model TEXT: Name of an LLM model to make available. Can be repeated. [default: gpt-5.5]--backend TEXT: Process backend to make available. Can be repeated. Supported: llm, codex, chat.--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 / --no-time: Enable time/datetime tools [default: time]--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--transcription-model TEXT: Realtime input audio transcription model. [default: gpt-realtime-whisper]--voice TEXT: Default OpenAI Realtime voice preset.--turn-detection [none|automatic]: OpenAI Realtime audio turn detection mode: none or automatic. [default: none]--realtime-protocol TEXT: Realtime connection protocol to advertise for OpenAI Realtime. Pass multiple times to set an ordered preference list.--output-modality TEXT: Restrict supported response output modalities to text or audio. Pass multiple times to allow multiple output modalities; omit to allow all.--input-audio-format TEXT: Realtime input audio MIME type. [default: audio/pcm]--input-audio-sample-rate INTEGER: Realtime input audio sample rate. [default: 24000]--input-audio-bitrate INTEGER: Realtime input audio bitrate.--output-audio-format TEXT: Realtime output audio MIME type. [default: audio/pcm]--output-audio-sample-rate INTEGER: Realtime output audio sample rate. [default: 24000]--output-audio-bitrate INTEGER: Realtime output audio bitrate.--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: default-new]--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument.--context-management [auto|standalone|none]: Context compaction mode for OpenAI Responses process agents: auto, standalone, or none. [default: auto]--compaction-threshold INTEGER: Token threshold for OpenAI Responses context compaction.--max-output-tokens INTEGER: Maximum output tokens to request from OpenAI Responses models. [default: 32000]--reasoning-effort TEXT: Reasoning effort to request from OpenAI Responses models.--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS[?reply-all=true|false], memory, queue:QUEUE_NAME, toolkit:NAME, websocket:PORT, websocket://HOST:PORT.--websocket-auth [iap|jwt|none]: Authentication mode for websocket channels: jwt, iap, or none. [default: jwt]--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]--profile: Print OpenTelemetry span timings for process startup and turns.--verbose-dataset: Persist streaming delta events to dataset thread storage for debugging--save-audio-input: Persist realtime audio input chunks to dataset thread storage as binary attachments.--help: Show this message and exit.
meshagent process service
Add a process-backed agent service to the host.
Usage:
--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--tool-search [room|agent|none]: Expose required toolkits through OpenAI Responses tool search. Use agent for statically configured non-OpenAI builtin tools, room for those plus annotated room toolkits, or none. [default: none]-s, --schema TEXT: the name or url of a required schema--model TEXT: Name of an LLM model to make available. Can be repeated. [default: gpt-5.5]--backend TEXT: Process backend to make available. Can be repeated. Supported: llm, codex, chat.--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 / --no-time: Enable time/datetime tools [default: time]--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--transcription-model TEXT: Realtime input audio transcription model. [default: gpt-realtime-whisper]--voice TEXT: Default OpenAI Realtime voice preset.--turn-detection [none|automatic]: OpenAI Realtime audio turn detection mode: none or automatic. [default: none]--realtime-protocol TEXT: Realtime connection protocol to advertise for OpenAI Realtime. Pass multiple times to set an ordered preference list.--output-modality TEXT: Restrict supported response output modalities to text or audio. Pass multiple times to allow multiple output modalities; omit to allow all.--input-audio-format TEXT: Realtime input audio MIME type. [default: audio/pcm]--input-audio-sample-rate INTEGER: Realtime input audio sample rate. [default: 24000]--input-audio-bitrate INTEGER: Realtime input audio bitrate.--output-audio-format TEXT: Realtime output audio MIME type. [default: audio/pcm]--output-audio-sample-rate INTEGER: Realtime output audio sample rate. [default: 24000]--output-audio-bitrate INTEGER: Realtime output audio bitrate.--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: default-new]--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument.--context-management [auto|standalone|none]: Context compaction mode for OpenAI Responses process agents: auto, standalone, or none. [default: auto]--compaction-threshold INTEGER: Token threshold for OpenAI Responses context compaction.--max-output-tokens INTEGER: Maximum output tokens to request from OpenAI Responses models. [default: 32000]--reasoning-effort TEXT: Reasoning effort to request from OpenAI Responses models.--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS[?reply-all=true|false], memory, queue:QUEUE_NAME, toolkit:NAME, websocket:PORT, websocket://HOST:PORT.--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-dataset: Persist streaming delta events to dataset thread storage for debugging--save-audio-input: Persist realtime audio input chunks to dataset thread storage as binary attachments.--help: Show this message and exit.
meshagent process spec
Generate a service spec for deploying a process-backed agent.
Usage:
--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--tool-search [room|agent|none]: Expose required toolkits through OpenAI Responses tool search. Use agent for statically configured non-OpenAI builtin tools, room for those plus annotated room toolkits, or none. [default: none]-s, --schema TEXT: the name or url of a required schema--model TEXT: Name of an LLM model to make available. Can be repeated. [default: gpt-5.5]--backend TEXT: Process backend to make available. Can be repeated. Supported: llm, codex, chat.--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 / --no-time: Enable time/datetime tools [default: time]--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--transcription-model TEXT: Realtime input audio transcription model. [default: gpt-realtime-whisper]--voice TEXT: Default OpenAI Realtime voice preset.--turn-detection [none|automatic]: OpenAI Realtime audio turn detection mode: none or automatic. [default: none]--realtime-protocol TEXT: Realtime connection protocol to advertise for OpenAI Realtime. Pass multiple times to set an ordered preference list.--output-modality TEXT: Restrict supported response output modalities to text or audio. Pass multiple times to allow multiple output modalities; omit to allow all.--input-audio-format TEXT: Realtime input audio MIME type. [default: audio/pcm]--input-audio-sample-rate INTEGER: Realtime input audio sample rate. [default: 24000]--input-audio-bitrate INTEGER: Realtime input audio bitrate.--output-audio-format TEXT: Realtime output audio MIME type. [default: audio/pcm]--output-audio-sample-rate INTEGER: Realtime output audio sample rate. [default: 24000]--output-audio-bitrate INTEGER: Realtime output audio bitrate.--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: default-new]--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument.--context-management [auto|standalone|none]: Context compaction mode for OpenAI Responses process agents: auto, standalone, or none. [default: auto]--compaction-threshold INTEGER: Token threshold for OpenAI Responses context compaction.--max-output-tokens INTEGER: Maximum output tokens to request from OpenAI Responses models. [default: 32000]--reasoning-effort TEXT: Reasoning effort to request from OpenAI Responses models.--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS[?reply-all=true|false], memory, queue:QUEUE_NAME, toolkit:NAME, websocket:PORT, websocket://HOST:PORT.--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
Deploy a process-backed agent service.
Usage:
--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--tool-search [room|agent|none]: Expose required toolkits through OpenAI Responses tool search. Use agent for statically configured non-OpenAI builtin tools, room for those plus annotated room toolkits, or none. [default: none]-s, --schema TEXT: the name or url of a required schema--model TEXT: Name of an LLM model to make available. Can be repeated. [default: gpt-5.5]--backend TEXT: Process backend to make available. Can be repeated. Supported: llm, codex, chat.--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 / --no-time: Enable time/datetime tools [default: time]--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--transcription-model TEXT: Realtime input audio transcription model. [default: gpt-realtime-whisper]--voice TEXT: Default OpenAI Realtime voice preset.--turn-detection [none|automatic]: OpenAI Realtime audio turn detection mode: none or automatic. [default: none]--realtime-protocol TEXT: Realtime connection protocol to advertise for OpenAI Realtime. Pass multiple times to set an ordered preference list.--output-modality TEXT: Restrict supported response output modalities to text or audio. Pass multiple times to allow multiple output modalities; omit to allow all.--input-audio-format TEXT: Realtime input audio MIME type. [default: audio/pcm]--input-audio-sample-rate INTEGER: Realtime input audio sample rate. [default: 24000]--input-audio-bitrate INTEGER: Realtime input audio bitrate.--output-audio-format TEXT: Realtime output audio MIME type. [default: audio/pcm]--output-audio-sample-rate INTEGER: Realtime output audio sample rate. [default: 24000]--output-audio-bitrate INTEGER: Realtime output audio bitrate.--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: default-new]--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument.--context-management [auto|standalone|none]: Context compaction mode for OpenAI Responses process agents: auto, standalone, or none. [default: auto]--compaction-threshold INTEGER: Token threshold for OpenAI Responses context compaction.--max-output-tokens INTEGER: Maximum output tokens to request from OpenAI Responses models. [default: 32000]--reasoning-effort TEXT: Reasoning effort to request from OpenAI Responses models.--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS[?reply-all=true|false], memory, queue:QUEUE_NAME, toolkit:NAME, websocket:PORT, websocket://HOST:PORT.--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
Run a process-backed agent and wait for messages.
Usage:
--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--preamble-rule / --no-preamble-rule: Include the default rule asking the model to send concise pre-tool preambles when no custom rules are configured. [default: preamble-rule]-rt, --require-toolkit TEXT: the name or url of a required toolkit--tool-search [room|agent|none]: Expose required toolkits through OpenAI Responses tool search. Use agent for statically configured non-OpenAI builtin tools, room for those plus annotated room toolkits, or none. [default: none]-s, --schema TEXT: the name or url of a required schema--model TEXT: Name of an LLM model to make available. Can be repeated. [default: gpt-5.5]--backend TEXT: Process backend to make available. Can be repeated. Supported: llm, codex, chat.--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 / --no-time: Enable time/datetime tools [default: time]--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--transcription-model TEXT: Realtime input audio transcription model. [default: gpt-realtime-whisper]--voice TEXT: Default OpenAI Realtime voice preset.--turn-detection [none|automatic]: OpenAI Realtime audio turn detection mode: none or automatic. [default: none]--realtime-protocol TEXT: Realtime connection protocol to advertise for OpenAI Realtime. Pass multiple times to set an ordered preference list.--output-modality TEXT: Restrict supported response output modalities to text or audio. Pass multiple times to allow multiple output modalities; omit to allow all.--input-audio-format TEXT: Realtime input audio MIME type. [default: audio/pcm]--input-audio-sample-rate INTEGER: Realtime input audio sample rate. [default: 24000]--input-audio-bitrate INTEGER: Realtime input audio bitrate.--output-audio-format TEXT: Realtime output audio MIME type. [default: audio/pcm]--output-audio-sample-rate INTEGER: Realtime output audio sample rate. [default: 24000]--output-audio-bitrate INTEGER: Realtime output audio bitrate.--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: default-new]--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument with a room, or none with —no-room.--context-management [auto|standalone|none]: Context compaction mode for OpenAI Responses process agents: auto, standalone, or none. [default: auto]--compaction-threshold INTEGER: Token threshold for OpenAI Responses context compaction.--max-output-tokens INTEGER: Maximum output tokens to request from OpenAI Responses models. [default: 32000]--reasoning-effort TEXT: Reasoning effort to request from OpenAI Responses models.--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS[?reply-all=true|false], memory, queue:QUEUE_NAME, toolkit:NAME, websocket:PORT, websocket://HOST:PORT.--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--profile: Print OpenTelemetry span timings for process startup and turns.--verbose-dataset: Persist streaming delta events to dataset thread storage for debugging--save-audio-input: Persist realtime audio input chunks to dataset thread storage as binary attachments.--no-room: Run locally without connecting to a room. Fails if room-backed storage, channels, or tools are configured.--websocket-auth [iap|jwt|none]: Authentication mode for websocket channels: jwt, iap, or none. [default: jwt]--user TEXT: User name for the local websocket process run client. [default: you]--thread-id TEXT: Thread id to open--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 threads
List threads for a process-backed agent.
Usage:
--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 list threads for--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument.--limit INTEGER: Maximum threads to show [default: 20]--offset INTEGER: Thread list offset [default: 0]-o, --output [json|table|text]: Output format: json, table, or text. [default: text]--help: Show this message and exit.
meshagent process messages
List messages in a process-backed agent thread.
Usage:
--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 inspect--thread-dir TEXT: Thread directory for agent thread files. Defaults to /agents/<agent-name>/threads for process agents when threading mode is enabled.--thread-storage TEXT: Thread storage backend for process agents. Can be repeated; the first value is the default. Defaults to dataset then meshdocument.--thread-id TEXT: Thread id to inspect [required]-o, --output [json|table|text]: Output format: json, table, or text. [default: text]--help: Show this message and exit.
meshagent process grep
Search coalesced messages in a process-backed agent thread.
Usage:
PATTERN: Regex pattern to search for [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--thread-id TEXT: Thread id to inspect [required]-o, --output [json|table|text]: Output format: json, table, or text. [default: text]--help: Show this message and exit.
meshagent process use
Send a one-shot or interactive message to a running process-backed agent.
Usage:
--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-id TEXT: Thread id to open--message TEXT: the input message to use--websocket-url TEXT: Connect to a process websocket channel instead of room chat.--websocket-auth [iap|jwt|none]: Authentication mode for —websocket-url: jwt, iap, or none. [default: iap]--user TEXT: User name for the websocket process use client. [default: you]--help: Show this message and exit.
meshagent room
Operate within a room
Usage:
--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 roomsecret: Manage room-scoped secrets and OAuth flowsqueue: Use queues in a roommessaging: Send and receive messages in a roomstorage: Manage storage for a roomservice: Manage services inside a roomdeveloper: Stream developer logs from a roomdataset: Manage dataset tables in a roommemory: Manage room memoriescontainer: Manage containers and images inside a roomsync: Inspect and update mesh documents in a roomconnect: Connect to a room and run a local command…
meshagent room agents
Interact with agents and toolkits in a room
Usage:
--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 roominvoke-tool: Invoke a specific tool from a toolkitlist-toolkits: List toolkits (and tools) available in the…
meshagent room agents call
Trigger agent/tool calls in a room
Usage:
--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 URLagent: Send a call request to an agent webhook URLtoolkit: Send a call request to a toolkit webhook URLschema: Send a call request to a schema webhook URL
meshagent room agents call tool
Send a call request to a tool webhook URL
Usage:
--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
Send a call request to an agent webhook URL
Usage:
--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
Send a call request to a toolkit webhook URL
Usage:
--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
Send a call request to a schema webhook URL
Usage:
--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
Invoke a specific tool from a toolkit
Usage:
--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--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
List toolkits (and tools) available in the room
Usage:
--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
Manage room-scoped secrets and OAuth flows
Usage:
--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
Request an OAuth token from another participant.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--from-participant-id TEXT: Participant ID to request the token from [required]--client-id TEXT: OAuth client ID [required]--authorization-endpoint TEXT: OAuth authorization endpoint URL [required]--token-endpoint TEXT: OAuth token endpoint URL [required]--scopes TEXT: Comma-separated OAuth scopes--client-secret TEXT: OAuth client secret (if required) [required]--redirect-uri TEXT: Redirect URI for the OAuth flow [required]--pkce / --no-pkce: Use PKCE (recommended) [default: pkce]--help: Show this message and exit.
meshagent room secret request
Request a secret from another participant.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--from-participant-id TEXT: Participant ID to request the secret from [required]--url TEXT: Secret URL identifier [required]--type TEXT: Secret type [default: application/octet-stream]--delegate-to TEXT: Delegate secret to this participant name--timeout INTEGER: Timeout in seconds [default: 300]-o, --out TEXT: Output file path, or ’-’ for stdout [default: -]--help: Show this message and exit.
meshagent room secret get
Fetch a stored secret by ID.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--id TEXT: Secret ID [required]--delegated-to TEXT: Fetch a secret delegated to this participant name-o, --out TEXT: Output file path, or ’-’ for stdout [default: -]--help: Show this message and exit.
meshagent room secret exists
Check whether a stored secret exists by ID.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--id TEXT: Secret ID [required]--delegated-to TEXT: Check a secret delegated to this participant name--for-identity TEXT: Check a secret for a specific identity--help: Show this message and exit.
meshagent room secret set
Store a secret by ID.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--id TEXT: Secret ID [required]--type TEXT: Secret type--name TEXT: Optional secret name--delegated-to TEXT: Store a secret delegated to this participant name--for-identity TEXT: Store a secret for a specific identity-i, --in TEXT: Input file path, or ’-’ for stdin--text TEXT: Provide secret as UTF-8 text--base64 TEXT: Provide secret as base64-encoded data--help: Show this message and exit.
meshagent room secret list
List secrets in the room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--help: Show this message and exit.
meshagent room secret delete
Delete a secret by ID.
Usage:
ID: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--delegated-to TEXT: The value of the delegated_to field of the secret, must be specified if secret was delegated--help: Show this message and exit.
meshagent room queue
Use queues in a room
Usage:
--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 queues in a room.send: Send a JSON message to a room queue.send-mail: Create an email message and send it to a…receive: Receive a message from a room queue.size: Show the current size of a room queue.
meshagent room queue list
List queues in a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent room queue send
Send a JSON message to a room queue.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--queue TEXT: Queue name [required]--json TEXT: a JSON message to send to the queue [required]-f, --file TEXT: File path to a JSON file--help: Show this message and exit.
meshagent room queue send-mail
Create an email message and send it to a room queue.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--queue TEXT: Queue name [required]--subject TEXT: Email subject [required]--body TEXT: Email body--from TEXT: Sender email address [required]--attachment TEXT: Attachment file path. May be provided multiple times.--help: Show this message and exit.
meshagent room queue receive
Receive a message from a room queue.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--queue TEXT: Queue name [required]--help: Show this message and exit.
meshagent room queue size
Show the current size of a room queue.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--queue TEXT: Queue name [required]--help: Show this message and exit.
meshagent room messaging
Send and receive messages in a room
Usage:
--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 messaging-enabled participantssend: Send a direct message to a participantbroadcast: Broadcast a message to all participants
meshagent room messaging list
List messaging-enabled participants
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--help: Show this message and exit.
meshagent room messaging send
Send a direct message to a participant
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--to-participant-id TEXT: Participant ID to send a message to [required]--type TEXT: type of the message to send [required]--data TEXT: JSON message to send [required]--help: Show this message and exit.
meshagent room messaging broadcast
Broadcast a message to all participants
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--data TEXT: JSON message to broadcast [required]--help: Show this message and exit.
meshagent room storage
Manage storage for a room
Usage:
--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.
exists: Check whether a path exists in room storage.cp: Copy files between local paths and room…get: Print file contents from local disk or…rm: Remove files or directories from local…ls: List files and directories locally or in…
meshagent room storage exists
Check whether a path exists in room storage.
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--help: Show this message and exit.
meshagent room storage cp
Copy files between local paths and room storage.
Usage:
SOURCE_PATH: [required]DEST_PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--help: Show this message and exit.
meshagent room storage get
Print file contents from local disk or room storage.
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--encoding TEXT: Text encoding [default: utf-8]--help: Show this message and exit.
meshagent room storage rm
Remove files or directories from local disk or room storage.
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-r: Remove directories/folders recursively--help: Show this message and exit.
meshagent room storage ls
List files and directories locally or in room storage.
Usage:
PATH: Path to list (local or room://…) [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-r: List subfolders/files recursively--help: Show this message and exit.
meshagent room service
Manage services inside a room
Usage:
--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 services running in a roomrestart: Restart a running room service by stopping…
meshagent room service list
List services running in a room
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent room service restart
Restart a running room service by stopping its current container.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--id TEXT: Service ID to restart--name TEXT: Service name to restart--help: Show this message and exit.
meshagent room developer
Stream developer logs from a room
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--format [plain|json]: Output format [default: plain]--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 room dataset
Manage dataset tables in a room
Usage:
--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.
branch: Manage dataset branches in a room namespace.table: List dataset tables in a room.inspect: Inspect a table schema in a room dataset.install: Install required tables from a…create: Create a room dataset table with optional…import: Import a local Arrow, CSV, TSV, Parquet,…drop: Drop a room dataset table.add-columns: Add columns to a room dataset table.drop-columns: Drop columns from a room dataset table.insert: Insert records into a room dataset table.merge: Upsert records into a room dataset table.update: Update rows in a room dataset table.delete: Delete rows from a room dataset table.search: Search rows in a room dataset table.sql: Execute SQL against room dataset tables.optimize: Optimize a room dataset table.stats: Show statistics for a room dataset table.version: List versions for a room dataset table.restore: Restore a room dataset table to a specific…index: List indexes on a room dataset table.index-create: Create an index on a room dataset table.index-drop: Drop an index from a room dataset table.
meshagent room dataset branch
Manage dataset branches in a room namespace.
Usage:
--help: Show this message and exit.
list: List dataset branches in a room namespace.get: Get a dataset branch.create: Create a dataset branch.delete: Delete a dataset branch.
meshagent room dataset branch list
List dataset branches in a room namespace.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room dataset branch get
Get a dataset branch.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--branch TEXT: Branch name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room dataset branch create
Create a dataset branch.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--branch TEXT: New branch name [required]--from-branch TEXT: Source branch to branch from-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--help: Show this message and exit.
meshagent room dataset branch delete
Delete a dataset branch.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--branch TEXT: Branch name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--help: Show this message and exit.
meshagent room dataset table
List dataset tables in a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--help: Show this message and exit.
meshagent room dataset inspect
Inspect a table schema in a room dataset.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-v, --version INTEGER: Historical table version to read (defaults to latest on the branch)--json: Output raw schema JSON--help: Show this message and exit.
meshagent room dataset install
Install required tables from a requirements JSON file.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--file TEXT: Path to requirements JSON file--help: Show this message and exit.
meshagent room dataset create
Create a room dataset table with optional Arrow schema and seed data.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]--mode TEXT: create | overwrite | create_if_not_exists [default: create]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-c, --columns TEXT: Comma-separated column definitions. Example: “names vector(20) null, tags list(text), meta struct(owner text, score float)”. CLI shorthand types: int, bool, date, timestamp, float, text, json, uuid, binary, vector, list, struct. Vector syntax: vector(size[, element_type]). List syntax: list(element_type). Struct syntax: struct(field_name type[, …]).--data-json TEXT: Initial rows (JSON list)--data-file TEXT: Path to JSON file with initial rows--help: Show this message and exit.
meshagent room dataset import
Import a local Arrow, CSV, TSV, Parquet, JSON, or Excel file into a table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-f, --file TEXT: Local file to import [required]--mode TEXT: Import mode: create, replace, merge [default: create]--format TEXT: Input format: auto, json, arrow, csv, tsv, parquet, excel [default: auto]--on TEXT: Column to match when —mode merge--sheet TEXT: Excel worksheet name for —format excel--batch-size INTEGER: Rows per imported batch for Parquet, JSON, and Excel [default: 8192]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--help: Show this message and exit.
meshagent room dataset drop
Drop a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--ignore-missing: Ignore missing table--help: Show this message and exit.
meshagent room dataset add-columns
Add columns to a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-c, --columns TEXT: Comma-separated column definitions. Example: “names vector(20) null, tags list(text), meta struct(owner text, score float)”. CLI shorthand types: int, bool, date, timestamp, float, text, json, uuid, binary, vector, list, struct. Vector syntax: vector(size[, element_type]). List syntax: list(element_type). Struct syntax: struct(field_name type[, …]).--columns-json TEXT: JSON object of new columns mapped to SQL default expressions (e.g. ’{“created_at”:“now()”}’).--help: Show this message and exit.
meshagent room dataset drop-columns
Drop columns from a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-c, --column TEXT: Column to drop (repeatable)--help: Show this message and exit.
meshagent room dataset insert
Insert records into a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--json TEXT: JSON list of records-f, --file TEXT: Path to JSON file (list of records)--help: Show this message and exit.
meshagent room dataset merge
Upsert records into a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]--on TEXT: Column to match for upsert [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--json TEXT: JSON records (list)-f, --file TEXT: Path to JSON file (list)--help: Show this message and exit.
meshagent room dataset update
Update rows in a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]--where TEXT: SQL WHERE clause, e.g. “id = 1” [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--values-json TEXT: JSON object of update values; use {“column”:{“expression”:”…”}} for expressions [required]--help: Show this message and exit.
meshagent room dataset delete
Delete rows from a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]--where TEXT: SQL WHERE clause [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--help: Show this message and exit.
meshagent room dataset search
Search rows in a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-v, --version INTEGER: Historical table version to read (defaults to latest on the branch)--text TEXT: Full-text query--vector-json TEXT: Vector JSON array--where TEXT: SQL WHERE clause--where-json TEXT: JSON object converted to equality ANDs--select TEXT: Columns to select (repeatable)--limit INTEGER: Max rows to return--offset INTEGER: Rows to skip--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room dataset sql
Execute SQL against room dataset tables.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-q, --query TEXT: SQL query to execute [required]-t, --table TEXT: Table name to register in SQL context (repeatable)-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--tables-json TEXT: JSON array of table refs (e.g. ’[{“name”:“users”,“alias”:“u”,“namespace”:[“prod”]}]’)--tables-file TEXT: Path/URL to JSON array of table refs (same format as —tables-json)--params-json TEXT: JSON object of SQL parameters for DataFusion param binding--params-file TEXT: Path/URL to JSON object of SQL parameters--branch TEXT: Dataset branch name (defaults to main)-v, --version INTEGER: Historical table version to read (defaults to latest on the branch)--pretty / --no-pretty: Pretty-print JSON [default: pretty]--format TEXT: Output format: table, json, arrow, csv, tsv, parquet, excel [default: table]-o, --output TEXT: Write output to this file path instead of stdout--help: Show this message and exit.
meshagent room dataset optimize
Optimize a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]--compact-files / --no-compact-files--optimize-indices / --no-optimize-indices--cleanup-old-versions / --no-cleanup-old-versions--target-rows-per-fragment INTEGER--max-rows-per-group INTEGER--max-bytes-per-file INTEGER--materialize-deletions / --no-materialize-deletions--materialize-deletions-threshold FLOAT--defer-index-remap / --no-defer-index-remap--num-threads INTEGER--batch-size INTEGER--compaction-mode TEXT: Compaction mode: reencode, try_binary_copy, or force_binary_copy--binary-copy-read-batch-bytes INTEGER--num-indices-to-merge INTEGER--index-name TEXT: Index name to optimize. Repeatable.--retrain / --no-retrain--older-than-seconds FLOAT--retain-versions INTEGER--delete-unverified / --keep-unverified--error-if-tagged-old-versions / --ignore-tagged-old-versions--delete-rate-limit INTEGER--config-json TEXT: JSON object with optimization fields.-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent room dataset stats
Show statistics for a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-v, --version INTEGER: Historical table version to read (defaults to latest on the branch)--max-rows-per-group INTEGER-o, --output TEXT: output format [default: table]--help: Show this message and exit.
meshagent room dataset version
List versions for a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room dataset restore
Restore a room dataset table to a specific version.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-v, --version INTEGER: Table version [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--help: Show this message and exit.
meshagent room dataset index
List indexes on a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)-v, --version INTEGER: Historical table version to read (defaults to latest on the branch)--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room dataset index-create
Create an index on a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]-c, --column TEXT: Column name. Repeat this option to pass multiple columns.--index-type TEXT: Lance index type, such as IVF_PQ, IVF_HNSW_PQ, IVF_HNSW_SQ, IVF_RQ, BTREE, BITMAP, LABEL_LIST, NGRAM, ZONEMAP, INVERTED, FTS, BLOOMFILTER, or RTREE.--name TEXT: Index name--metric TEXT: Vector distance metric, such as L2, cosine, or dot--replace / --no-replace: Replace existing index if it already exists--train / --no-train: Train the index on existing data--num-partitions INTEGER--target-partition-size INTEGER--num-sub-vectors INTEGER--num-bits INTEGER--accelerator TEXT--index-cache-size INTEGER--shuffle-partition-batches INTEGER--shuffle-partition-concurrency INTEGER--ivf-centroids-file TEXT--precomputed-partition-dataset TEXT--filter-nan / --no-filter-nan: Filter null or NaN vector values--index-uuid TEXT--skip-transpose / --no-skip-transpose: Skip vector index transposition--index-file-version TEXT--max-level INTEGER--m INTEGER--ef-construction INTEGER--with-position / --no-with-position: Store token positions for text indexes--memory-limit INTEGER--num-workers INTEGER--skip-merge / --no-skip-merge: Skip text index partition merge--base-tokenizer TEXT--language TEXT--max-token-length INTEGER--lower-case / --no-lower-case: Lowercase text index tokens--stem / --no-stem: Stem text index tokens--remove-stop-words / --keep-stop-words: Remove text index stop words--custom-stop-word TEXT: Custom stop word. Repeat to pass multiple words.--ascii-folding / --no-ascii-folding: Fold text index tokens to ASCII--config-json TEXT: JSON object with Lance index configuration fields.-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--help: Show this message and exit.
meshagent room dataset index-drop
Drop an index from a room dataset table.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-t, --table TEXT: Table name [required]--name TEXT: Index name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--branch TEXT: Dataset branch name (defaults to main)--help: Show this message and exit.
meshagent room memory
Manage room memories
Usage:
--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 memories in a room namespace.create: Create a room memory store.drop: Drop a room memory store.inspect: Inspect metadata and datasets for a memory.get: Get metadata and datasets for a memory.query: Run a SQL-like query against memory datasets.upsert-table: Upsert records from JSON into memory tables.upsert-nodes: Upsert entity nodes into memory.upsert-relationships: Upsert relationship edges into memory.import: Import entities and relationships from a…ingest-text: Extract memory from input text.ingest-image: Extract memory from an image.ingest-file: Extract memory from local file/text content.ingest-from-table: Extract memory from table rows.ingest-from-storage: Extract memory from room storage paths.recall: Recall entities and relationships from…delete-entities: Delete entities (and related edges) from…delete-relationships: Delete relationship edges from memory.optimize: Optimize memory datasets.
meshagent room memory list
List memories in a room namespace.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory create
Create a room memory store.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--overwrite: Overwrite existing memory--help: Show this message and exit.
meshagent room memory drop
Drop a room memory store.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--ignore-missing: Ignore missing memory--help: Show this message and exit.
meshagent room memory inspect
Inspect metadata and datasets for a memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory get
Get metadata and datasets for a memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory query
Run a SQL-like query against memory datasets.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-s, --statement TEXT: Statement, e.g. “MATCH (e:Entity) RETURN e.name LIMIT 10” [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory upsert-table
Upsert records from JSON into memory tables.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-t, --table TEXT: Table name [required]--records-json TEXT: JSON array of records--records-file TEXT: Path to JSON file with records-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--merge / --no-merge: Merge with existing records [default: merge]--help: Show this message and exit.
meshagent room memory upsert-nodes
Upsert entity nodes into memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]--records-json TEXT: JSON array of MemoryEntityRecord objects--records-file TEXT: Path to JSON file with entity records-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--merge / --no-merge: Merge with existing nodes [default: merge]--help: Show this message and exit.
meshagent room memory upsert-relationships
Upsert relationship edges into memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]--records-json TEXT: JSON array of MemoryRelationshipRecord objects--records-file TEXT: Path to JSON file with relationship records-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--merge / --no-merge: Merge with existing relationships [default: merge]--help: Show this message and exit.
meshagent room memory import
Import entities and relationships from a FalkorDB dump.rdb file.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-f, --rdb-file PATH: Path to FalkorDB dump.rdb file [required]--graph-name TEXT: FalkorDB graph key name. Auto-detected when unambiguous.-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--merge / --no-merge: Merge with existing records [default: merge]--batch-size INTEGER RANGE: Rows per GRAPH.QUERY batch while importing [default: 250; x>=1]--docker-image TEXT: Docker image to use for temporary FalkorDB container [default: falkordb/falkordb:latest]--startup-timeout-seconds FLOAT RANGE: Max seconds to wait for FalkorDB startup [default: 30.0; x>=1.0]--create-memory / --no-create-memory: Create the target memory when missing [default: create-memory]--help: Show this message and exit.
meshagent room memory ingest-text
Extract memory from input text.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]--text TEXT: Text content to ingest-f, --file TEXT: Path to UTF-8 text file-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--strategy [heuristic|llm]: Ingest strategy: heuristic or llm [default: heuristic]--llm-model TEXT: Model name for llm strategy--llm-temperature FLOAT: Temperature for llm strategy--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory ingest-image
Extract memory from an image.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-f, --file TEXT: Path to image file--caption TEXT: Optional image caption--mime-type TEXT: Image mime type--source TEXT: Source identifier/path--annotations-json TEXT: Optional JSON map of string annotations, e.g. {“origin”:“camera”}-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--strategy [heuristic|llm]: Ingest strategy: heuristic or llm [default: heuristic]--llm-model TEXT: Model name for llm strategy--llm-temperature FLOAT: Temperature for llm strategy--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory ingest-file
Extract memory from local file/text content.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]--path TEXT: File path available to the room server--text TEXT: Inline text content--text-file TEXT: Path to local UTF-8 text file--mime-type TEXT: Optional mime type-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--strategy [heuristic|llm]: Ingest strategy: heuristic or llm [default: heuristic]--llm-model TEXT: Model name for llm strategy--llm-temperature FLOAT: Temperature for llm strategy--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory ingest-from-table
Extract memory from table rows.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-t, --table TEXT: Source table name [required]--text-column TEXT: Source text columns (repeatable)--table-namespace TEXT: Namespace path segments for the source table (repeatable)--limit INTEGER: Maximum source rows-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--strategy [heuristic|llm]: Ingest strategy: heuristic or llm [default: heuristic]--llm-model TEXT: Model name for llm strategy--llm-temperature FLOAT: Temperature for llm strategy--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory ingest-from-storage
Extract memory from room storage paths.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-p, --path TEXT: Room storage path to ingest (repeatable) [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--strategy [heuristic|llm]: Ingest strategy: heuristic or llm [default: heuristic]--llm-model TEXT: Model name for llm strategy--llm-temperature FLOAT: Temperature for llm strategy--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory recall
Recall entities and relationships from memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-q, --query TEXT: Recall query text [required]--limit INTEGER: Max entities to return [default: 5]--include-relationships / --no-include-relationships: Include related edges for recalled entities [default: include-relationships]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory delete-entities
Delete entities (and related edges) from memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-e, --entity-id TEXT: Entity ID to delete (repeatable) [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory delete-relationships
Delete relationship edges from memory.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]--records-json TEXT: JSON array of MemoryRelationshipSelector objects--records-file TEXT: Path to JSON file with relationship selectors-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room memory optimize
Optimize memory datasets.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-m, --name TEXT: Memory name [required]-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics--compact / --no-compact: Compact dataset fragments [default: compact]--cleanup / --no-cleanup: Cleanup old dataset versions [default: cleanup]--pretty / --no-pretty: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room container
Manage containers and images inside a room
Usage:
--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.
image: Image operationslist: List containers in a room.stop: Stop a running container in a room.log: Print container logs from a room.exec: Execute a command inside a running container.run: Run a container inside a room.
meshagent room container image
Image operations
Usage:
--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 container images available in a room.inspect: Inspect a container image in a room by…delete: Delete a container image from a room.pull: Pull a container image into a room.push: Push a container image from a room.load: Load an OCI image archive from room…save: Save an OCI image archive from a room.
meshagent room container image list
List container images available in a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--output TEXT: table | json [default: table]--help: Show this message and exit.
meshagent room container image inspect
Inspect a container image in a room by image ID.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--image-id TEXT: Image ID frommeshagent images list[required]--help: Show this message and exit.
meshagent room container image delete
Delete a container image from a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--image TEXT: Image ref/tag to delete [required]--help: Show this message and exit.
meshagent room container image pull
Pull a container image into a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--tag TEXT: Image tag/ref to pull [required]--cred TEXT: Docker creds (username,password) or (registry,username,password)--help: Show this message and exit.
meshagent room container image push
Push a container image from a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--tag TEXT: Image tag/ref to push [required]--private / --public: Whether the push container is private to the participant [default: public]--cred TEXT: Docker creds (username,password) or (registry,username,password)--help: Show this message and exit.
meshagent room container image load
Load an OCI image archive from room storage into a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-i, --archive-path, --image TEXT: Absolute room storage path to the OCI image archive file [required]--help: Show this message and exit.
meshagent room container image save
Save an OCI image archive from a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--tag TEXT: Image tag/ref to save [required]--archive-path TEXT: Path to write OCI archive inside one of the mounted paths (absolute path) [required]--mount-room-path TEXT: Room storage mount ‘<source>:<mount>[:ro|rw]’. Example ‘/images:/workspace’--mount-project-path TEXT: Project storage mount ‘<source>:<mount>[:ro|rw]’. Example ‘/shared:/project:ro’--mount-image TEXT: Image mount ‘<image>=<mount>[:ro|rw]’. Example ‘alpine:latest=/toolchain:ro’--private / --public: Whether the save container is private to the participant [default: public]--help: Show this message and exit.
meshagent room container list
List containers in a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-a, --all: Include exited containers in the listing.--output TEXT: json | table [default: json]--help: Show this message and exit.
meshagent room container stop
Stop a running container in a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--id TEXT: Container ID [required]--help: Show this message and exit.
meshagent room container log
Print container logs from a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--id TEXT: Container ID [required]--follow / --no-follow: Stream logs [default: no-follow]--help: Show this message and exit.
meshagent room container exec
Execute a command inside a running container.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--container-id TEXT: container id [required]--command TEXT: Command to execute in the container (quoted string)--help: Show this message and exit.
meshagent room container run
Run a container inside a room.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--image TEXT: Image to run [required]--command TEXT: Command to execute in the container (quoted string)--working-dir TEXT: Working directory inside the container (must be an absolute path)-e, --env TEXT: KEY=VALUE-p, --port TEXT: CONTAINER:HOST--cred TEXT: Docker creds (username,password) or (registry,username,password)--mount-path TEXT: Room storage path to mount into the container--mount-subpath TEXT: Subpath within--mount-pathto mount--participant-name TEXT: Participant name to associate with the run--role TEXT: Role to run the container as [default: user]--container-name TEXT: Optional container name--template TEXT: Allowed values: agent, none. agent: MeshAgent mounts room storage at /data, sets MESHAGENT_TOKEN, OPENAI_API_KEY, and ANTHROPIC_API_KEY to a container-scoped MeshAgent token. agent also sets SMTP_PASSWORD to that token, SMTP_USERNAME to the container name, SMTP_PORT to 587, SMTP_HOSTNAME from MESHAGENT_MAIL_DOMAIN when available, plus OPENAI_BASE_URL, ANTHROPIC_BASE_URL, MESHAGENT_API_URL, MESHAGENT_ROOM_URL, MESHAGENT_ROOM, MESHAGENT_PROJECT_ID, MESHAGENT_SESSION_ID, OTEL_ENDPOINT, OTEL_PYTHON_LOG_LEVEL, and MESHAGENT_MAIL_DOMAIN from the room runtime when available. Manual env values win. none: MeshAgent applies no template defaults. [default: none]--help: Show this message and exit.
meshagent room sync
Inspect and update mesh documents in a room
Usage:
--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.
import: Import Anthropic Claude GDPR conversations…get: Print the full document JSONgrep: Search the document for matching contentinspect: Print the document schema JSONcreate: Create a new document at a pathupdate: Apply a JSON patch to a document
meshagent room sync import
Import Anthropic Claude GDPR conversations into room thread documents.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]-f, --file PATH: Path to Claude GDPR conversations.json [required]--thread-dir TEXT: Directory where imported .thread files will be stored [default: .threads/anthropic]--overwrite: Overwrite existing imported thread files--limit INTEGER RANGE: Maximum number of conversations to import [x>=1]--user-name, --human-name TEXT: Author name used for user/human messages [default: human]--assistant-name TEXT: Author name used for assistant messages [default: assistant]--include-empty-messages: Include messages that normalize to empty text--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 room sync get
Print the full document JSON
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--include-ids: Include $id attributes in output--pretty / --compact: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room sync grep
Search the document for matching content
Usage:
PATH: [required]PATTERN: Regex pattern to match [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--ignore-case: Ignore case--before INTEGER RANGE: Include siblings before [default: 0; x>=0]--after INTEGER RANGE: Include siblings after [default: 0; x>=0]--include-ids: Include $id attributes in output--pretty / --compact: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room sync inspect
Print the document schema JSON
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--pretty / --compact: Pretty-print JSON [default: pretty]--help: Show this message and exit.
meshagent room sync create
Create a new document at a path
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--schema PATH: Schema JSON file [required]--json TEXT: Initial JSON payload--json-file PATH: Path to initial JSON payload--help: Show this message and exit.
meshagent room sync update
Apply a JSON patch to a document
Usage:
PATH: [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--room TEXT: Room name [default: (dynamic)]--patch TEXT: JSON patch array--patch-file PATH: Path to JSON patch array--help: Show this message and exit.
meshagent room connect
Connect to a room and run a local command with MESHAGENT_API_URL, MESHAGENT_PROJECT_ID, MESHAGENT_TOKEN, OPENAI_API_KEY, ANTHROPIC_API_KEY, and MESHAGENT_ROOM set by the default agent template. Use — before the local command.
Usage:
[COMMAND]...
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used.--room TEXT: Room name-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 the connected token, —meshagent-token, and —env-secret. Required with —role, —meshagent-token, and —env-secret. When set, room connect mints a participant token locally.--role TEXT: Participant role for locally minted tokens. Requires —identity and defaults to agent.--meshagent-token TEXT: Inject MESHAGENT_TOKEN using userDefault, agentDefault, full, or a JSON ApiScope object.--template TEXT: Allowed values: agent, none. agent: MeshAgent sets MESHAGENT_TOKEN, OPENAI_API_KEY, and ANTHROPIC_API_KEY to a room-scoped MeshAgent token, and sets OPENAI_BASE_URL, ANTHROPIC_BASE_URL, MESHAGENT_API_URL, MESHAGENT_PROJECT_ID, and MESHAGENT_ROOM from the connected room unless manually set. none: MeshAgent applies no template defaults. [default: agent]--help: Show this message and exit.
meshagent llm
Local LLM proxy utilities
Usage:
--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.
logger: Manage project LLM loggersproxy: Expose a local MeshAgent-authenticated LLM…
meshagent llm logger
Manage project LLM loggers
Usage:
--help: Show this message and exit.
create: Create an LLM logger.update: Update an LLM logger.get: Get an LLM logger.list: List LLM loggers for the project.delete: Delete an LLM logger.
meshagent llm logger create
Create an LLM logger.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--destination-feed-id, --feed-id TEXT: Destination feed id [required]-f, --filter-expression TEXT: JMESPath metadata filter [required]--paused: Create the logger in a paused state--annotations TEXT: annotations in json format {“name”:“value”}--help: Show this message and exit.
meshagent llm logger update
Update an LLM logger.
Usage:
LOGGER_ID: LLM logger id to update [required]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--destination-feed-id, --feed-id TEXT: Destination feed id-f, --filter-expression TEXT: JMESPath metadata filter--paused: Pause the logger--resume: Resume a paused logger--annotations TEXT: annotations in json format {“name”:“value”}--help: Show this message and exit.
meshagent llm logger get
Get an LLM logger.
Usage:
LOGGER_ID: LLM logger id to get [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 llm logger list
List LLM loggers for the project.
Usage:
--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 llm logger delete
Delete an LLM logger.
Usage:
LOGGER_ID: LLM logger 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 llm proxy
Expose a local MeshAgent-authenticated LLM proxy.
Usage:
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [default: (dynamic)]--host TEXT: Local host to bind the proxy to. [default: 127.0.0.1]--port INTEGER: Local port to bind the proxy to. [default: 8766]--bearer TEXT: Explicit local bearer token. If omitted, the stored token is reused or generated on first run.--token-from-env TEXT: Name of environment variable containing a MeshAgent token to forward upstream.--insecure: Disable local bearer-token enforcement.--tui / --no-tui: Show the live usage dashboard when attached to a TTY. [default: tui]--help: Show this message and exit.