`meshagent`

Usage:

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

Options:

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

Commands:

version: Print the version
setup: Perform initial login and project/api key…
call: Trigger agent/tool calls via URL
auth: Authenticate to meshagent
project: Manage or activate your meshagent projects
api-key: Manage or activate api-keys for your project
session: Inspect recent sessions and events
token: Generate participant tokens (JWTs)
webhook: Manage project webhooks
service: Manage services for your project
mcp: Bridge MCP servers into MeshAgent rooms
secret: Manage secrets for your project.
helper: Developer helper services
helpers: Developer helper services
rooms: Create, list, and manage rooms in a project
mailbox: Manage mailboxes for your project
route: Manage routes for your project
scheduled-task: Manage scheduled tasks for your project
meeting-transcriber: Join a meeting transcriber to a room
port: Port forwarding into room containers
webserver: Run an HTTP webserver connected to a…
codex: Codex-backed agents
multi: Connect agents and tools to a room
voicebot: Join a voicebot to a room
chatbot: Join a chatbot to a room
process: Join a process-backed agent to a room
mailbot: Join a mailbot to a room
task-runner: Join a taskrunner to a room
worker: Join a worker agent to a room
room: Operate within a room

`meshagent version`

Print the version Usage:

$ meshagent version [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent setup`

Perform initial login and project/api key activation. Usage:

$ meshagent setup [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent call`

Trigger agent/tool calls via URL Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent call tool`

Send a call request to a tool webhook URL Usage:

$ meshagent call tool [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 call agent`

Send a call request to an agent webhook URL Usage:

$ meshagent call agent [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 call toolkit`

Send a call request to a toolkit webhook URL Usage:

$ meshagent call toolkit [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 call schema`

Send a call request to a schema webhook URL Usage:

$ meshagent call schema [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 auth`

Authenticate to meshagent Usage:

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

Options:

--help: Show this message and exit.

Commands:

login
logout
whoami

Usage:

$ meshagent auth login [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent auth logout`

Usage:

$ meshagent auth logout [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent auth whoami`

Usage:

$ meshagent auth whoami [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent project`

Manage or activate your meshagent projects Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent project create`

Create a new MeshAgent project. Usage:

$ meshagent project create [OPTIONS] NAME

Arguments:

NAME: [required]

Options:

--help: Show this message and exit.

`meshagent project list`

List projects and mark the currently active one. Usage:

$ meshagent project list [OPTIONS]

Options:

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

$ meshagent project activate [OPTIONS] [PROJECT_ID]

Arguments:

[PROJECT_ID]

Options:

-i, --interactive: Interactively select or create a project
--help: Show this message and exit.

`meshagent api-key`

Manage or activate api-keys for your project Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List API keys for a project.
create: Create a new API key for a project.
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:

$ meshagent api-key list [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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:

$ meshagent api-key create [OPTIONS] NAME

Arguments:

NAME: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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 activate`

Set the default API key for a project in local CLI settings. Usage:

$ meshagent api-key activate [OPTIONS] KEY

Arguments:

KEY: [required]

Options:

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

`meshagent api-key delete`

Delete an API key from a project. Usage:

$ meshagent api-key delete [OPTIONS] ID

Arguments:

ID: [required]

Options:

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

`meshagent session`

Inspect recent sessions and events Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List recent sessions
show: Show events for a session

`meshagent session list`

List recent sessions Usage:

$ meshagent session list [OPTIONS]

Options:

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

`meshagent session show`

Show events for a session Usage:

$ meshagent session show [OPTIONS] SESSION_ID

Arguments:

SESSION_ID: [required]

Options:

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

`meshagent token`

Generate participant tokens (JWTs) Usage:

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

Options:

--help: Show this message and exit.

Commands:

generate: Generate a participant token (JWT) from a…

`meshagent token generate`

Generate a participant token (JWT) from a spec Usage:

$ meshagent token generate [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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
--help: Show this message and exit.

`meshagent webhook`

Manage project webhooks Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent webhook create`

Create a webhook Usage:

$ meshagent webhook create [OPTIONS]

Options:

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

`meshagent webhook list`

List webhooks Usage:

$ meshagent webhook list [OPTIONS]

Options:

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

`meshagent webhook delete`

Delete a webhook Usage:

$ meshagent webhook delete [OPTIONS] WEBHOOK_ID

Arguments:

WEBHOOK_ID: ID of the webhook to delete [required]

Options:

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

`meshagent service`

Manage services for your project Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent service spec`

Render a service or template YAML spec without creating a service. Usage:

$ meshagent service spec [OPTIONS]

Options:

-f, --file TEXT: File path to a service definition
--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. Usage:

$ meshagent service create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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:

$ meshagent service update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

$ meshagent service validate [OPTIONS]

Options:

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

$ meshagent service create-template [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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:

$ meshagent service update-template [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

$ meshagent service validate-template [OPTIONS]

Options:

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

`meshagent service render-template`

Render a service template with variables and print the rendered YAML. Usage:

$ meshagent service render-template [OPTIONS]

Options:

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

`meshagent service run`

Run a local command and register it as a temporary room service. Usage:

$ meshagent service run [OPTIONS] COMMAND

Arguments:

COMMAND: [required]

Options:

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

`meshagent service show`

Show a services for the project. Usage:

$ meshagent service show [OPTIONS] SERVICE_ID

Arguments:

SERVICE_ID: ID of the service to show [required]

Options:

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

`meshagent service list`

List all services for the project. Usage:

$ meshagent service list [OPTIONS]

Options:

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

`meshagent service delete`

Delete a service. Usage:

$ meshagent service delete [OPTIONS] SERVICE_ID

Arguments:

SERVICE_ID: ID of the service to delete [required]

Options:

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

`meshagent mcp`

Bridge MCP servers into MeshAgent rooms Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent mcp sse`

Connect an MCP server over SSE and register it as a toolkit Usage:

$ meshagent mcp sse [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent mcp http [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent mcp stdio [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent mcp http-proxy [OPTIONS]

Options:

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

`meshagent mcp sse-proxy`

Expose a stdio MCP server over SSE Usage:

$ meshagent mcp sse-proxy [OPTIONS]

Options:

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

`meshagent mcp stdio-service`

Run a stdio MCP server as an HTTP service Usage:

$ meshagent mcp stdio-service [OPTIONS]

Options:

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

`meshagent secret`

Manage secrets for your project. Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List all secrets in the project (typed as…
delete: Delete a secret.
key: Create or update environment-based…
keys: 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…

`meshagent secret list`

List all secrets in the project (typed as Docker/ACR/GAR or Keys secrets). Usage:

$ meshagent secret list [OPTIONS]

Options:

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

`meshagent secret delete`

Delete a secret. Usage:

$ meshagent secret delete [OPTIONS] SECRET_ID

Arguments:

SECRET_ID: ID of the secret to delete [required]

Options:

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

`meshagent secret key`

Create or update environment-based key-value secrets. Usage:

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

Options:

--help: Show this message and exit.

Commands:

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:

$ meshagent secret key create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

$ meshagent secret key update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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 keys`

Create or update environment-based key-value secrets. Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent secret keys create`

Create a new ‘keys’ secret (opaque env-vars). Usage:

$ meshagent secret keys create [OPTIONS]

Options:

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

`meshagent secret keys update`

Update an existing ‘keys’ secret (opaque env-vars). Usage:

$ meshagent secret keys update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

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

Options:

--help: Show this message and exit.

Commands:

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:

$ meshagent secret docker create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

$ meshagent secret docker update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

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

Options:

--help: Show this message and exit.

Commands:

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:

$ meshagent secret acr create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [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 acr update`

Update an existing ACR pull secret (defaults email to ‘none@microsoft.com’). Usage:

$ meshagent secret acr update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

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

Options:

--help: Show this message and exit.

Commands:

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:

$ meshagent secret gar create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [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 gar update`

Update an existing Google Artifact Registry pull secret. Usage:

$ meshagent secret gar update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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 helper`

Developer helper services Usage:

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

Options:

--help: Show this message and exit.

Commands:

service: Run local helper HTTP services

`meshagent helper service`

Run local helper HTTP services Usage:

$ meshagent helper service [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent helpers`

Developer helper services Usage:

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

Options:

--help: Show this message and exit.

Commands:

service: Run local helper HTTP services

`meshagent helpers service`

Run local helper HTTP services Usage:

$ meshagent helpers service [OPTIONS]

Options:

--help: Show this message and exit.

`meshagent rooms`

Create, list, and manage rooms in a project Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent rooms create`

Create a room in the project. Usage:

$ meshagent rooms create [OPTIONS]

Options:

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

`meshagent rooms delete`

Delete a room by ID (or by name if —name is supplied). Usage:

$ meshagent rooms delete [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

$ meshagent rooms update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--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:

$ meshagent rooms list [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--limit INTEGER RANGE: Max rooms to return [default: 50; 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]
--help: Show this message and exit.

`meshagent rooms get`

Get a single room by name (handy for resolving the ID). Usage:

$ meshagent rooms get [OPTIONS]

Options:

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

`meshagent mailbox`

Manage mailboxes for your project Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent mailbox create`

Create a mailbox attached to the project. Usage:

$ meshagent mailbox create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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:

$ meshagent mailbox update [OPTIONS] ADDRESS

Arguments:

ADDRESS: Mailbox email address to update [required]

Options:

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

`meshagent mailbox show`

Show mailbox details. Usage:

$ meshagent mailbox show [OPTIONS] ADDRESS

Arguments:

ADDRESS: Mailbox address to show [required]

Options:

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

`meshagent mailbox list`

List mailboxes for the project. Usage:

$ meshagent mailbox list [OPTIONS]

Options:

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

`meshagent mailbox delete`

Delete a mailbox. Usage:

$ meshagent mailbox delete [OPTIONS] ADDRESS

Arguments:

ADDRESS: Mailbox address to delete [required]

Options:

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

`meshagent route`

Manage routes for your project Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent route create`

Create a route attached to the project. Usage:

$ meshagent route create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-d, --domain TEXT: Domain name to route (unique per project) [required]
--room TEXT: Room name
-p, --port TEXT: Published port to route to [required]
-n, --annotations TEXT: annotations in json format {“name”:“value”}
--help: Show this message and exit.

`meshagent route update`

Update a route configuration. Usage:

$ meshagent route update [OPTIONS] DOMAIN

Arguments:

DOMAIN: Domain name to update [required]

Options:

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

`meshagent route show`

Show route details. Usage:

$ meshagent route show [OPTIONS] DOMAIN

Arguments:

DOMAIN: Domain name to show [required]

Options:

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

`meshagent route list`

List routes for the project. Usage:

$ meshagent route list [OPTIONS]

Options:

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

`meshagent route delete`

Delete a route. Usage:

$ meshagent route delete [OPTIONS] DOMAIN

Arguments:

DOMAIN: Domain name to delete [required]

Options:

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

`meshagent scheduled-task`

Manage scheduled tasks for your project Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent scheduled-task add`

Add a scheduled task. Usage:

$ meshagent scheduled-task add [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-r, --room TEXT: Room name
-q, --queue TEXT: Queue name to dispatch the task to [required]
-s, --schedule TEXT: Cron schedule for task execution [required]
--payload TEXT: JSON payload to enqueue (for example ’{“action”:“sync”}’)
--payload-file TEXT: Path to a file containing JSON payload
--id TEXT: Optional task id
--once: Run once and then deactivate
--active / --inactive: Initial active state [default: active]
-n, --annotations TEXT: annotations in json format {“name”:“value”}
--help: Show this message and exit.

`meshagent scheduled-task list`

List scheduled tasks. Usage:

$ meshagent scheduled-task list [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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
--limit INTEGER: Maximum number of tasks to return [default: 200]
--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:

$ meshagent scheduled-task update [OPTIONS] TASK_ID

Arguments:

TASK_ID: Scheduled task id to update [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-r, --room TEXT: Updated room name
-q, --queue TEXT: Updated queue name
-s, --schedule TEXT: Updated cron schedule
--payload TEXT: Updated JSON payload to enqueue (for example ’{“action”:“sync”}’)
--payload-file TEXT: Path to a file containing updated JSON payload
--active: Mark the task active
--inactive: Mark the task inactive
-n, --annotations TEXT: annotations in json format {“name”:“value”}
--help: Show this message and exit.

`meshagent scheduled-task delete`

Delete a scheduled task. Usage:

$ meshagent scheduled-task delete [OPTIONS] TASK_ID

Arguments:

TASK_ID: Scheduled task id to delete [required]

Options:

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

`meshagent meeting-transcriber`

Join a meeting transcriber to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

join: Join a room and run the meeting…
service

`meshagent meeting-transcriber join`

Join a room and run the meeting transcriber agent. Usage:

$ meshagent meeting-transcriber join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent meeting-transcriber service [OPTIONS]

Options:

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

`meshagent port`

Port forwarding into room containers Usage:

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

Options:

--help: Show this message and exit.

Commands:

forward: Forward a container port to localhost

`meshagent port forward`

Forward a container port to localhost Usage:

$ meshagent port forward [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-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]
--help: Show this message and exit.

`meshagent webserver`

Run an HTTP webserver connected to a MeshAgent room. The webserver mounts static files/folders and python handlers from a routes file. Python handlers run with access to the active room and request objects. This lets you build web applications that take advantage of the MeshAgent room’s full feature set. Default routes file: webserver.yaml Add routes with the CLI: meshagent webserver add —path / —python handlers/home.py meshagent webserver add —path /assets —static ./public Start it locally by joining a room: meshagent webserver join —room my-room —agent-name my-web -f webserver.yaml —watch View the site from your local machine: http://127.0.0.1:8000 Use the host/port from webserver.yaml (or explicit —host/—port or —web-host/—web-port overrides). To make the site available outside your machine: meshagent webserver deploy —service-name my-web —agent-name my-web —room my-room -f webserver.yaml —website-path /website —domain my-web.meshagent.app --domain automatically creates or updates the route to the deployed room and webserver port. If the domain already targets a different room, deploy fails to avoid accidental repoints. Without --domain, create the route manually: meshagent route create —room my-room —port 8000 —domain my-web.meshagent.app Route source path rules:

python and static sources that start with / resolve to {cwd}/....
python and static sources without a leading / resolve relative to the routes file.
static supports both files and directories.
Set --app-dir to control Python import root (defaults to routes file directory).

Example routes file: kind: WebServer version: v1 host: 0.0.0.0 port: 8000 routes:

path: / methods:
- GET python: handlers/home.py
path: /assets static: ./public

Example python handler (handlers/home.py): from aiohttp import web from meshagent.api import RoomClient async def handler( *, room: RoomClient, req: web.Request, ) -> web.StreamResponse: return web.Response(text=“hello”) Usage:

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

Options:

--help: Show this message and exit.

Commands:

check: Validate a routes file and print the…
init: Create a routes file scaffold.
add: Add a route entry to the routes file.
join: Join a room and run the configured…
spec: Generate a service spec for deploying this…
deploy: Deploy this webserver as a service,…

`meshagent webserver check`

Validate a routes file and print the resolved routes. Usage:

$ meshagent webserver check [OPTIONS]

Options:

-f TEXT: Path to routes file (default: webserver.yaml). YAML format: kind: WebServer, version: v1, host?, port?, routes: [{path, methods?, python?|static?}]. Route source resolution: ‘/x’ -> ‘{cwd}/x’; ‘x’ -> relative to routes file. ‘static’ supports files and directories. Use —app-dir to control Python import root (defaults to routes file directory). When —host/—port (or —web-host/—web-port) are not explicitly set, host/port from the routes file are used. Python handler signature: handler(*, room: RoomClient, req: web.Request) -> web.StreamResponse. Do not define METHOD/METHODS in handler files. [default: webserver.yaml]
--app-dir TEXT: Python import root for route handlers (similar to uvicorn —app-dir). Defaults to the routes file directory.
--help: Show this message and exit.

`meshagent webserver init`

Create a routes file scaffold. Add routes with the CLI: meshagent webserver add —path / —python handlers/home.py meshagent webserver add —path /assets —static ./public Usage:

$ meshagent webserver init [OPTIONS]

Options:

-f TEXT: Path to routes file (default: webserver.yaml). YAML format: kind: WebServer, version: v1, host?, port?, routes: [{path, methods?, python?|static?}]. Route source resolution: ‘/x’ -> ‘{cwd}/x’; ‘x’ -> relative to routes file. ‘static’ supports files and directories. Use —app-dir to control Python import root (defaults to routes file directory). When —host/—port (or —web-host/—web-port) are not explicitly set, host/port from the routes file are used. Python handler signature: handler(*, room: RoomClient, req: web.Request) -> web.StreamResponse. Do not define METHOD/METHODS in handler files. [default: webserver.yaml]
--force: Overwrite existing routes file
--help: Show this message and exit.

`meshagent webserver add`

Add a route entry to the routes file. Usage:

$ meshagent webserver add [OPTIONS]

Options:

--path TEXT: Route path to add (must start with ’/’) [required]
--python TEXT: Python handler path (relative to routes file); scaffolded if missing
--static TEXT: Static file or directory path (relative to routes file)
-m, --method TEXT: HTTP method for python routes (repeatable)
-f TEXT: Path to routes file (default: webserver.yaml). YAML format: kind: WebServer, version: v1, host?, port?, routes: [{path, methods?, python?|static?}]. Route source resolution: ‘/x’ -> ‘{cwd}/x’; ‘x’ -> relative to routes file. ‘static’ supports files and directories. Use —app-dir to control Python import root (defaults to routes file directory). When —host/—port (or —web-host/—web-port) are not explicitly set, host/port from the routes file are used. Python handler signature: handler(*, room: RoomClient, req: web.Request) -> web.StreamResponse. Do not define METHOD/METHODS in handler files. [default: webserver.yaml]
--help: Show this message and exit.

`meshagent webserver join`

Join a room and run the configured webserver routes locally with optional hot reload. Usage:

$ meshagent webserver join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
--key TEXT: an api key to sign the token with
-f TEXT: Path to routes file (default: webserver.yaml). YAML format: kind: WebServer, version: v1, host?, port?, routes: [{path, methods?, python?|static?}]. Route source resolution: ‘/x’ -> ‘{cwd}/x’; ‘x’ -> relative to routes file. ‘static’ supports files and directories. Use —app-dir to control Python import root (defaults to routes file directory). When —host/—port (or —web-host/—web-port) are not explicitly set, host/port from the routes file are used. Python handler signature: handler(*, room: RoomClient, req: web.Request) -> web.StreamResponse. Do not define METHOD/METHODS in handler files. [default: webserver.yaml]
--app-dir TEXT: Python import root for route handlers (similar to uvicorn —app-dir). Defaults to the routes file directory.
--host TEXT: Host to bind the server [default: 127.0.0.1]
--port INTEGER: Port to bind the server [default: 8000]
--watch: Reload routes when the routes file or python handlers change
--help: Show this message and exit.

`meshagent webserver spec`

Generate a service spec for deploying this webserver configuration. Usage:

$ meshagent webserver spec [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-f TEXT: Path to routes file (default: webserver.yaml). YAML format: kind: WebServer, version: v1, host?, port?, routes: [{path, methods?, python?|static?}]. Route source resolution: ‘/x’ -> ‘{cwd}/x’; ‘x’ -> relative to routes file. ‘static’ supports files and directories. Use —app-dir to control Python import root (defaults to routes file directory). When —host/—port (or —web-host/—web-port) are not explicitly set, host/port from the routes file are used. Python handler signature: handler(*, room: RoomClient, req: web.Request) -> web.StreamResponse. Do not define METHOD/METHODS in handler files. [default: webserver.yaml]
--app-dir TEXT: Python import root for route handlers (similar to uvicorn —app-dir). Defaults to the routes file directory.
--web-host TEXT: Host to bind the webserver [default: 0.0.0.0]
--web-port INTEGER: Port to bind the webserver [default: 8000]
--website-path TEXT: Required room storage subpath for route-referenced files (under the routes file directory) and the routes config file; adds a room storage mount so routes resolve in container (example: /website) [required]
--help: Show this message and exit.

`meshagent webserver deploy`

Deploy this webserver as a service, updating an existing service with the same name. Usage:

$ meshagent webserver deploy [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-f TEXT: Path to routes file (default: webserver.yaml). YAML format: kind: WebServer, version: v1, host?, port?, routes: [{path, methods?, python?|static?}]. Route source resolution: ‘/x’ -> ‘{cwd}/x’; ‘x’ -> relative to routes file. ‘static’ supports files and directories. Use —app-dir to control Python import root (defaults to routes file directory). When —host/—port (or —web-host/—web-port) are not explicitly set, host/port from the routes file are used. Python handler signature: handler(*, room: RoomClient, req: web.Request) -> web.StreamResponse. Do not define METHOD/METHODS in handler files. [default: webserver.yaml]
--app-dir TEXT: Python import root for route handlers (similar to uvicorn —app-dir). Defaults to the routes file directory.
--web-host TEXT: Host to bind the webserver [default: 0.0.0.0]
--web-port INTEGER: Port to bind the webserver [default: 8000]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--domain TEXT: Domain to create/update route for this deploy (must already target this room if it exists)
--website-path TEXT: Required room storage subpath to upload route-referenced files (under the routes file directory) and the routes config file into and mount at runtime (example: /website) [required]
--help: Show this message and exit.

`meshagent codex`

Codex-backed agents Usage:

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

Options:

--help: Show this message and exit.

Commands:

chatbot: Run codex chatbot agents
task-runner: Run codex task-runner agents
worker: Run codex worker agents

`meshagent codex chatbot`

Run codex chatbot agents Usage:

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

Options:

--help: Show this message and exit.

Commands:

join: Join a room and run a Codex chatbot agent.
service
spec: Generate a service spec for deploying a…
deploy: Deploy a Codex chatbot service to a…
run: Join a room, start a Codex chatbot, and…
use: Send a one-shot or interactive message to…

`meshagent codex chatbot join`

Join a room and run a Codex chatbot agent. Usage:

$ meshagent codex chatbot join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--role TEXT: Role to use for the agent token [default: agent]
--agent-name TEXT: Name of the agent to run
--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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--key TEXT: An api key to sign the token with
--help: Show this message and exit.

`meshagent codex chatbot service`

Usage:

$ meshagent codex chatbot service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to run [required]
--title TEXT: A friendly title for the chatbot
--description TEXT: A description for the chatbot
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex chatbot spec`

Generate a service spec for deploying a Codex chatbot. Usage:

$ meshagent codex chatbot spec [OPTIONS]

Options:

--service-name TEXT: Service name [required]
--service-description TEXT: Service description
--service-title TEXT: A display name for service
--agent-name TEXT: Name of the agent to run [required]
--title TEXT: A friendly title for the chatbot
--description TEXT: A description for the chatbot
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex chatbot deploy`

Deploy a Codex chatbot service to a project or room. Usage:

$ meshagent codex chatbot deploy [OPTIONS]

Options:

--service-name TEXT: Service name [required]
--service-description TEXT: Service description
--service-title TEXT: A display name for service
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--agent-name TEXT: Name of the agent to run [required]
--title TEXT: A friendly title for the chatbot
--description TEXT: A description for the chatbot
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex chatbot run`

Join a room, start a Codex chatbot, and wait for messages. Usage:

$ meshagent codex chatbot run [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--role TEXT: Role to use for the agent token [default: agent]
--agent-name TEXT: Name of the agent to run
--token-from-env TEXT: Name of environment variable containing a MeshAgent token
--title TEXT: A friendly title for the chatbot
--description TEXT: A description for the chatbot
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--key TEXT: An api key to sign the token with
--thread-path TEXT: Thread path to use for chat history
--message TEXT: Optional one-shot message
--use-web-search / --no-use-web-search: Request the web search tool
--use-image-gen / --no-use-image-gen: Request the image generation tool
--use-storage / --no-use-storage: Request the storage tool
--help: Show this message and exit.

`meshagent codex chatbot use`

Send a one-shot or interactive message to a running Codex chatbot. Usage:

$ meshagent codex chatbot use [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--agent-name TEXT: Name of the agent to call
--thread-path TEXT: Thread path to use for chat history
--message TEXT: Optional one-shot message
--use-web-search / --no-use-web-search: Request the web search tool
--use-image-gen / --no-use-image-gen: Request the image generation tool
--use-storage / --no-use-storage: Request the storage tool
--help: Show this message and exit.

`meshagent codex task-runner`

Run codex task-runner agents Usage:

$ meshagent codex task-runner [OPTIONS] COMMAND [ARGS]...

Options:

--help: Show this message and exit.

Commands:

join: Join a room and run a Codex task-runner…
run: Join a room, start a Codex task-runner,…
service
spec: Generate a service spec for deploying a…
deploy: Deploy a Codex task-runner service to a…

`meshagent codex task-runner join`

Join a room and run a Codex task-runner agent. Usage:

$ meshagent codex task-runner join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--role TEXT: Role to use for the agent token [default: agent]
--agent-name TEXT: Name of the agent to run
--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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--title TEXT: A friendly title for the task runner
--description TEXT: A description for the task runner
--supports-tools / --no-supports-tools: Whether the task runner supports tools [default: supports-tools]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--key TEXT: An api key to sign the token with
--help: Show this message and exit.

`meshagent codex task-runner run`

Join a room, start a Codex task-runner, and wait for tasks. Usage:

$ meshagent codex task-runner run [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--role TEXT: Role to use for the agent token [default: agent]
--agent-name TEXT: Name of the agent to run
--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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--title TEXT: A friendly title for the task runner
--description TEXT: A description for the task runner
--supports-tools / --no-supports-tools: Whether the task runner supports tools [default: supports-tools]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--key TEXT: An api key to sign the token with
--input TEXT: JSON input for the task runner, or ’-’ for stdin
--with-caller / --no-with-caller: Whether to invoke the tool with the currently logged in user as the caller [default: with-caller]
--help: Show this message and exit.

`meshagent codex task-runner service`

Usage:

$ meshagent codex task-runner service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to run [required]
--title TEXT: A friendly title for the task runner
--description TEXT: A description for the task runner
--supports-tools / --no-supports-tools: Whether the task runner supports tools [default: supports-tools]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex task-runner spec`

Generate a service spec for deploying a Codex task-runner. Usage:

$ meshagent codex task-runner spec [OPTIONS]

Options:

--service-name TEXT: Service name [required]
--service-description TEXT: Service description
--service-title TEXT: A display name for service
--agent-name TEXT: Name of the agent to run [required]
--title TEXT: A friendly title for the task runner
--description TEXT: A description for the task runner
--supports-tools / --no-supports-tools: Whether the task runner supports tools [default: supports-tools]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex task-runner deploy`

Deploy a Codex task-runner service to a project or room. Usage:

$ meshagent codex task-runner deploy [OPTIONS]

Options:

--service-name TEXT: Service name [required]
--service-description TEXT: Service description
--service-title TEXT: A display name for service
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--agent-name TEXT: Name of the agent to run [required]
--title TEXT: A friendly title for the task runner
--description TEXT: A description for the task runner
--supports-tools / --no-supports-tools: Whether the task runner supports tools [default: supports-tools]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex worker`

Run codex worker agents Usage:

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

Options:

--help: Show this message and exit.

Commands:

join: Join a room and run a Codex worker agent.
service
spec: Generate a service spec for deploying a…
deploy: Deploy a Codex worker service to a project…

`meshagent codex worker join`

Join a room and run a Codex worker agent. Usage:

$ meshagent codex worker join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--role TEXT: Role to use for the agent token [default: agent]
--agent-name TEXT: Name of the agent to run
--token-from-env TEXT: Name of environment variable containing a MeshAgent token
--queue TEXT: The queue to consume [required]
--title TEXT: A friendly title for the worker
--description TEXT: A description for the worker
--supports-context / --no-supports-context: Whether to merge caller context messages [default: supports-context]
--prompt TEXT: Override prompt used for each message
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--toolkit-name TEXT: Optional toolkit name to expose worker operations
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--key TEXT: An api key to sign the token with
--help: Show this message and exit.

`meshagent codex worker service`

Usage:

$ meshagent codex worker service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to run [required]
--queue TEXT: The queue to consume [required]
--title TEXT: A friendly title for the worker
--description TEXT: A description for the worker
--supports-context / --no-supports-context: Whether to merge caller context messages [default: supports-context]
--prompt TEXT: Override prompt used for each message
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--toolkit-name TEXT: Optional toolkit name to expose worker operations
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex worker spec`

Generate a service spec for deploying a Codex worker. Usage:

$ meshagent codex worker spec [OPTIONS]

Options:

--service-name TEXT: Service name [required]
--service-description TEXT: Service description
--service-title TEXT: A display name for service
--agent-name TEXT: Name of the agent to run [required]
--queue TEXT: The queue to consume [required]
--title TEXT: A friendly title for the worker
--description TEXT: A description for the worker
--supports-context / --no-supports-context: Whether to merge caller context messages [default: supports-context]
--prompt TEXT: Override prompt used for each message
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--toolkit-name TEXT: Optional toolkit name to expose worker operations
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent codex worker deploy`

Deploy a Codex worker service to a project or room. Usage:

$ meshagent codex worker deploy [OPTIONS]

Options:

--service-name TEXT: Service name [required]
--service-description TEXT: Service description
--service-title TEXT: A display name for service
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--agent-name TEXT: Name of the agent to run [required]
--queue TEXT: The queue to consume [required]
--title TEXT: A friendly title for the worker
--description TEXT: A description for the worker
--supports-context / --no-supports-context: Whether to merge caller context messages [default: supports-context]
--prompt TEXT: Override prompt used for each message
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--toolkit-name TEXT: Optional toolkit name to expose worker operations
-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
-rt, --require-toolkit TEXT: The name or url of a required toolkit
-rs, --require-schema TEXT: The name or url of a required schema
--model TEXT: Codex model to use [default: gpt-5.4-codex]
--command TEXT: Command used to launch codex app-server
--ws-url TEXT: Websocket URL for an existing codex app-server
--codex-image TEXT: Container image used to run codex app-server; use ‘none’ to disable [default: meshagent/shell-codex:default]
--mount-room-path TEXT: Mount room storage as <source>:<mount>[:ro|rw]
--mount-project-path TEXT: Mount project storage as <source>:<mount>[:ro|rw]
--working-dir TEXT: Working directory passed to codex app-server
--approval-policy TEXT: Codex approval policy
--sandbox-policy TEXT: Codex sandbox policy
--mode [default|yolo|workspace-write|read-only]: Preset Codex mode: default | yolo | workspace-write | read-only
--skill-dir TEXT: An agent skills directory
--verbose: Log codex app-server JSON-RPC requests/responses
--delegate-shell-token: Pass the room token through to codex app-server as MESHAGENT_TOKEN / OPENAI_API_KEY / ANTHROPIC_API_KEY.
--copy-env TEXT: Copy local env vars into codex app-server env. Accepts comma-separated names and can be repeated.
--set-env TEXT: Set env vars in codex app-server env as NAME=VALUE. Can be repeated.
--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
--help: Show this message and exit.

`meshagent multi`

Connect agents and tools to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

spec: Generate a combined service spec from…
deploy: Deploy a combined service from multiple…
service
join: Run multiple join commands together in one…

`meshagent multi spec`

Generate a combined service spec from multiple subcommands. Usage:

$ meshagent multi spec [OPTIONS]

Options:

-c TEXT: a list of sub commands to run, seperated by semicolons

available sub commands: chatbot …; mailbot …; worker …; voicebot …; webserver …; python path-to-python-file.py —name=NameOfModule; chatbot, worker, mailbot, voicebot, and webserver command arguments mirror those of the respective meshagent chatbot service, meshagent worker service, meshagent mailbot service, meshagent voicebot service, and meshagent webserver service commands. [required]

--service-name TEXT: service name [required]
--agent-name TEXT: identity for injected MESHAGENT_TOKEN [required]
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--help: Show this message and exit.

`meshagent multi deploy`

Deploy a combined service from multiple subcommands. Usage:

$ meshagent multi deploy [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-c TEXT: a list of sub commands to run, seperated by semicolons

--service-name TEXT: service name [required]
--agent-name TEXT: identity for injected MESHAGENT_TOKEN [required]
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--room TEXT: The name of a room to create the service for
--help: Show this message and exit.

`meshagent multi service`

Usage:

$ meshagent multi service [OPTIONS]

Options:

--host TEXT: Host to bind the service on
--port INTEGER: Port to bind the service on
-c TEXT: a list of sub commands to run, seperated by semicolons

--help: Show this message and exit.

`meshagent multi join`

Run multiple join commands together in one process. Usage:

$ meshagent multi join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
-c TEXT: a list of sub commands to run, seperated by semicolons

-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 [required]
--key TEXT: an api key to sign the token with
--agent-name TEXT: Name of the agent to call
--help: Show this message and exit.

`meshagent voicebot`

Join a voicebot to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent voicebot join`

Join a room and run a voicebot agent. Usage:

$ meshagent voicebot join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent voicebot service [OPTIONS]

Options:

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

`meshagent voicebot spec`

Generate a service spec for deploying a voicebot. Usage:

$ meshagent voicebot spec [OPTIONS]

Options:

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

`meshagent voicebot deploy`

Deploy a voicebot service to a project or room. Usage:

$ meshagent voicebot deploy [OPTIONS]

Options:

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

`meshagent chatbot`

Join a chatbot to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent chatbot join`

Join a room and run a chatbot agent. Usage:

$ meshagent chatbot join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-document-authoring / --no-require-document-authoring: Enable MeshDocument authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--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
--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 chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--help: Show this message and exit.

`meshagent chatbot service`

Usage:

$ meshagent chatbot service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-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
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--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]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--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 chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--help: Show this message and exit.

`meshagent chatbot spec`

Generate a service spec for deploying a chatbot. Usage:

$ meshagent chatbot spec [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-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
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--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]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--always-reply / --no-always-reply: Always reply
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--help: Show this message and exit.

`meshagent chatbot deploy`

Deploy a chatbot service to a project or room. Usage:

$ meshagent chatbot deploy [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-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
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--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]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--always-reply / --no-always-reply: Always reply
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--help: Show this message and exit.

`meshagent chatbot run`

Join a room, run the chatbot, and wait for messages. Usage:

$ meshagent chatbot run [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-document-authoring / --no-require-document-authoring: Enable MeshDocument authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--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
--always-reply / --no-always-reply: Always reply
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--verbose: Enable verbose logging and disable default log suppression
--thread-path TEXT: log all requests to the llm
--message TEXT: the input message to use
--use-web-search / --no-use-web-search: request the web search tool
--use-image-gen / --no-use-image-gen: request the image gen tool
--use-storage / --no-use-storage: request the storage tool
--help: Show this message and exit.

`meshagent chatbot use`

Send a one-shot or interactive message to a running chatbot. Usage:

$ meshagent chatbot use [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--agent-name TEXT: Name of the agent to call
--thread-path TEXT: log all requests to the llm
--message TEXT: the input message to use
--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`

Join a process-backed agent to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent process join`

Join a room and run a process-backed agent. Usage:

$ meshagent process join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-document-authoring / --no-require-document-authoring: Enable MeshDocument authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--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
--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 chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--help: Show this message and exit.

`meshagent process service`

Add a process-backed agent service to the host. Usage:

$ meshagent process service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-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
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--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]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--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 chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--help: Show this message and exit.

`meshagent process spec`

Generate a service spec for deploying a process-backed agent. Usage:

$ meshagent process spec [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-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
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--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]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--always-reply / --no-always-reply: Always reply
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--help: Show this message and exit.

`meshagent process deploy`

Deploy a process-backed agent service. Usage:

$ meshagent process deploy [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-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
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--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]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--always-reply / --no-always-reply: Always reply
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--help: Show this message and exit.

`meshagent process run`

Join a room, run a process-backed agent, and wait for messages. Usage:

$ meshagent process run [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--computer-use / --no-computer-use: Enable computer use [default: no-computer-use]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--require-image-generation TEXT: Name of an image gen model
--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
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-document-authoring / --no-require-document-authoring: Enable MeshDocument authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--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
--always-reply / --no-always-reply: Always reply
--threading-mode [none|default-new]: Threading mode for chat UIs. Use ‘default-new’ to show a new-thread composer before loading a thread. [default: none]
--thread-dir TEXT: Thread directory for chat thread files. Defaults to .threads/<agent-name> when not provided.
--channel TEXT: Attach a channel to the agent process. Can be repeated. Currently supported: chat, mail:EMAIL_ADDRESS, queue:QUEUE_NAME, toolkit:NAME.
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: log all requests to the llm [default: no-delegate-shell-token]
--shell-copy-env TEXT: Copy local env vars into shell tool env. Accepts comma-separated names and can be repeated.
--shell-set-env TEXT: Set env vars in shell tool env as NAME=VALUE. Can be repeated.
--log-llm-requests / --no-log-llm-requests: log all requests to the llm [default: no-log-llm-requests]
--verbose: Enable verbose logging and disable default log suppression
--thread-path TEXT: log all requests to the llm
--message TEXT: the input message to use
--use-web-search / --no-use-web-search: request the web search tool
--use-image-gen / --no-use-image-gen: request the image gen tool
--use-storage / --no-use-storage: request the storage tool
--help: Show this message and exit.

`meshagent process use`

Send a one-shot or interactive message to a running process-backed agent. Usage:

$ meshagent process use [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--agent-name TEXT: Name of the agent to call
--thread-path TEXT: log all requests to the llm
--message TEXT: the input message to use
--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 mailbot`

Join a mailbot to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent mailbot join`

Join a room and run a mailbot agent. Usage:

$ meshagent mailbot join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
--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
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--key TEXT: an api key to sign the token with
--queue TEXT: the name of the mail queue
--email-address TEXT: the email address of the agent [required]
--toolkit-name TEXT: the name of a toolkit to expose mail operations
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--whitelist TEXT: an email to whitelist
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--reply-all / --no-reply-all: Reply-all when responding to emails [default: no-reply-all]
--enable-attachments / --no-enable-attachments: Allow downloading and processing email attachments [default: no-enable-attachments]
--working-dir TEXT: The default working directory for shell commands
--skill-dir TEXT: an agent skills directory
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: Delegate the room token to shell tools [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 mailbot service`

Usage:

$ meshagent mailbot service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--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
--queue TEXT: the name of the mail queue
--email-address TEXT: the email address of the agent [required]
--toolkit-name TEXT: the name of a toolkit to expose mail operations
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--whitelist TEXT: an email to whitelist
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--reply-all / --no-reply-all: Reply-all when responding to emails [default: no-reply-all]
--enable-attachments / --no-enable-attachments: Allow downloading and processing email attachments [default: no-enable-attachments]
--working-dir TEXT: The default working directory for shell commands
--skill-dir TEXT: an agent skills directory
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: Delegate the room token to shell tools [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 mailbot spec`

Generate a service spec for deploying a mailbot. Usage:

$ meshagent mailbot spec [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--queue TEXT: the name of the mail queue
--email-address TEXT: the email address of the agent [required]
--toolkit-name TEXT: the name of a toolkit to expose mail operations
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--whitelist TEXT: an email to whitelist
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--reply-all / --no-reply-all: Reply-all when responding to emails [default: no-reply-all]
--enable-attachments / --no-enable-attachments: Allow downloading and processing email attachments [default: no-enable-attachments]
--working-dir TEXT: The default working directory for shell commands
--skill-dir TEXT: an agent skills directory
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: Delegate the room token to shell tools [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 mailbot deploy`

Deploy a mailbot service to a project or room. Usage:

$ meshagent mailbot deploy [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-rt, --require-toolkit TEXT: the name or url of a required toolkit
-rs, --require-schema TEXT: the name or url of a required schema
--model TEXT: Name of the LLM model to use for the chatbot [default: gpt-5.4]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--discover-script-tools / --no-discover-script-tools: Automatically add script tools from the room [default: no-discover-script-tools]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--queue TEXT: the name of the mail queue
--email-address TEXT: the email address of the agent [required]
--toolkit-name TEXT: the name of a toolkit to expose mail operations
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--whitelist TEXT: an email to whitelist
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Use a specific database namespace
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--reply-all / --no-reply-all: Reply-all when responding to emails [default: no-reply-all]
--enable-attachments / --no-enable-attachments: Allow downloading and processing email attachments [default: no-enable-attachments]
--working-dir TEXT: The default working directory for shell commands
--skill-dir TEXT: an agent skills directory
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--shell-image TEXT: an image tag to use to run shell commands in
--delegate-shell-token / --no-delegate-shell-token: Delegate the room token to shell tools [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. [required]
--room TEXT: The name of a room to create the service for
--help: Show this message and exit.

`meshagent task-runner`

Join a taskrunner to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

join: Join a room and run a task-runner agent.
run: Join a room, run the task-runner, and wait…
service
spec: Generate a service spec for deploying a…
deploy: Deploy a task-runner service to a project…

`meshagent task-runner join`

Join a room and run a task-runner agent. Usage:

$ meshagent task-runner join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
--model TEXT: Name of the LLM model to use for the task runner [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--require-document-authoring / --no-require-document-authoring: Enable MeshDocument authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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.
--key TEXT: an api key to sign the token with
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--output-schema TEXT: an output schema to use
--output-schema-path TEXT: the path or url to output schema to use
-a, --annotations TEXT: annotations in json format {“name”:“value”} [default: {“meshagent.task-runner.attachment-format”:“tar”}]
--title TEXT: a friendly name for the task runner
--description TEXT: a description for the task runner
--allow-model-selection / --no-allow-model-selection: a description for the task runner [default: allow-model-selection]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--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 task-runner run`

Join a room, run the task-runner, and wait for tasks. Usage:

$ meshagent task-runner run [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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
--model TEXT: Name of the LLM model to use for the task runner [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--require-document-authoring / --no-require-document-authoring: Enable MeshDocument authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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.
--key TEXT: an api key to sign the token with
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--output-schema TEXT: an output schema to use
--output-schema-path TEXT: the path or url to output schema to use
-a, --annotations TEXT: annotations in json format {“name”:“value”} [default: {“meshagent.task-runner.attachment-format”:“tar”}]
--title TEXT: a friendly name for the task runner
--description TEXT: a description for the task runner
--allow-model-selection / --no-allow-model-selection: a description for the task runner [default: allow-model-selection]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--input TEXT: json input for the task runner, or ’-’ for stdin
--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
--with-caller / --no-with-caller: whether to invoke the tool with the currently logged in user as the caller [default: with-caller]
--help: Show this message and exit.

`meshagent task-runner service`

Usage:

$ meshagent task-runner service [OPTIONS]

Options:

--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--model TEXT: Name of the LLM model to use for the task runner [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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.
--require-document-authoring / --no-require-document-authoring: Enable document authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--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
--output-schema TEXT: an output schema to use
--output-schema-path TEXT: the path or url to output schema to use
-a, --annotations TEXT: annotations in json format {“name”:“value”} [default: {“meshagent.task-runner.attachment-format”:“tar”}]
--title TEXT: a friendly name for the task runner
--description TEXT: a description for the task runner
--allow-model-selection / --no-allow-model-selection: a description for the task runner [default: allow-model-selection]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--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 task-runner spec`

Generate a service spec for deploying a task-runner. Usage:

$ meshagent task-runner spec [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--model TEXT: Name of the LLM model to use for the task runner [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-image-generation TEXT: Name of an image gen model
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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.
--require-document-authoring / --no-require-document-authoring: Enable document authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--output-schema TEXT: an output schema to use
--output-schema-path TEXT: the path or url to output schema to use
-a, --annotations TEXT: annotations in json format {“name”:“value”} [default: {“meshagent.task-runner.attachment-format”:“tar”}]
--title TEXT: a friendly name for the task runner
--description TEXT: a description for the task runner
--allow-model-selection / --no-allow-model-selection: a description for the task runner [default: allow-model-selection]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--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 task-runner deploy`

Deploy a task-runner service to a project or room. Usage:

$ meshagent task-runner deploy [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the agent to call [required]
-r, --rule TEXT: a system rule
--rules-file TEXT
-rr, --room-rules TEXT: a path to a rules file within the room that can be used to customize the agent’s behavior
--model TEXT: Name of the LLM model to use for the task runner [default: gpt-5.4]
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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]
--require-image-generation TEXT: Name of an image gen model
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool [default: no-require-apply-patch]
--require-web-search / --no-require-web-search: Enable web search tool calling [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Enable web fetch tool calling [default: no-require-web-fetch]
--require-mcp / --no-require-mcp: Enable mcp tool calling [default: no-require-mcp]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-table-read TEXT: Enable table read tools for a specific table
--require-table-write TEXT: Enable table write tools for a specific table
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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.
--require-document-authoring / --no-require-document-authoring: Enable document authoring [default: no-require-document-authoring]
--require-discovery / --no-require-discovery: Enable discovery of agents and tools [default: no-require-discovery]
--llm-participant TEXT: Delegate LLM interactions to a remote participant
--output-schema TEXT: an output schema to use
--output-schema-path TEXT: the path or url to output schema to use
-a, --annotations TEXT: annotations in json format {“name”:“value”} [default: {“meshagent.task-runner.attachment-format”:“tar”}]
--title TEXT: a friendly name for the task runner
--description TEXT: a description for the task runner
--allow-model-selection / --no-allow-model-selection: a description for the task runner [default: allow-model-selection]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--thread-name-rule TEXT: Rule for generating auto thread names (repeatable)
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--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 worker`

Join a worker agent to a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent worker join`

Join a room and run a worker agent. Usage:

$ meshagent worker join [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--role TEXT: [default: agent]
--agent-name TEXT: Name of the worker agent
--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
--model TEXT: Name of the LLM model to use [default: gpt-5.4]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--require-local-shell / --no-require-local-shell: Enable local shell tool calling [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Require web search tool [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Require web fetch tool [default: no-require-web-fetch]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--key TEXT: an api key to sign the token with
--queue TEXT: the queue to consume [required]
--toolkit-name TEXT: optional toolkit name to expose worker operations
-rr, --room-rules TEXT: path(s) in room storage to load rules from
--image-generation TEXT: Name of an image gen model
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--require-storage / --no-require-storage: Enable storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Enable read only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Use a specific database namespace (JSON list or dotted)
--require-table-read TEXT: Enable table read tools for these tables
--require-table-write TEXT: Enable table write tools for these tables
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--title TEXT: a display name for the agent
--description TEXT: a description for the agent
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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]
--prompt TEXT: a prompt to use for the worker
--help: Show this message and exit.

`meshagent worker service`

Usage:

$ meshagent worker service [OPTIONS]

Options:

--agent-name TEXT: Name of the worker agent [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
--model TEXT: Name of the LLM model to use [default: gpt-5.4]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--image-generation TEXT: Name of an image gen model
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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]
--require-local-shell / --no-require-local-shell: Require local shell tool [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Require web search tool [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Require web fetch tool [default: no-require-web-fetch]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--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
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--queue TEXT: the queue to consume [required]
--toolkit-name TEXT: Toolkit name to expose (optional)
-rr, --room-rules TEXT: Path(s) to rules files inside the room
--require-storage / --no-require-storage: Require storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Require read-only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Database namespace (e.g. foo::bar)
--require-table-read TEXT: Require table read tool for table (repeatable)
--require-table-write TEXT: Require table write tool for table (repeatable)
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--title TEXT: a display name for the agent
--description TEXT: a description for the agent
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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]
--prompt TEXT: a prompt to use for the worker
--help: Show this message and exit.

`meshagent worker spec`

Generate a service spec for deploying a worker. Usage:

$ meshagent worker spec [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the worker agent [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
--model TEXT: Name of the LLM model to use [default: gpt-5.4]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--image-generation TEXT: Name of an image gen model
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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]
--require-local-shell / --no-require-local-shell: Require local shell tool [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Require web search tool [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Require web fetch tool [default: no-require-web-fetch]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--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-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--queue TEXT: the queue to consume [required]
--toolkit-name TEXT: Toolkit name to expose (optional)
-rr, --room-rules TEXT: Path(s) to rules files inside the room
--require-storage / --no-require-storage: Require storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Require read-only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Database namespace (e.g. foo::bar)
--require-table-read TEXT: Require table read tool for table (repeatable)
--require-table-write TEXT: Require table write tool for table (repeatable)
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--title TEXT: a display name for the agent
--description TEXT: a description for the agent
--working-dir TEXT: The default working directory for shell commands
--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: Delegate the room token to shell tools [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]
--prompt TEXT: a prompt to use for the worker
--help: Show this message and exit.

`meshagent worker deploy`

Deploy a worker service to a project or room. Usage:

$ meshagent worker deploy [OPTIONS]

Options:

--service-name TEXT: service name
--service-description TEXT: service description
--service-title TEXT: a display name for the service
--agent-name TEXT: Name of the worker agent [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
--model TEXT: Name of the LLM model to use [default: gpt-5.4]
--threading-mode [auto|manual|none]: Threading mode: none (no persistence), manual (input path), or auto (LLM-selected thread path) [default: none]
--thread-dir TEXT: Thread directory for auto mode; thread path is <thread_dir>/<name>.thread [default: .threads]
--initial-message [summary|code|none]: Initial thread message mode: summary (LLM summary), code (markdown code block), or none [default: code]
--initial-message-from TEXT: Author name used for the initial thread message [default: worker]
--decision-model TEXT: Model used for summary decisions and payload summarization
--image-generation TEXT: Name of an image gen model
--require-shell / --no-require-shell: Enable function shell tool calling [default: no-require-shell]
--local-shell / --no-local-shell: Enable local shell tool calling [default: no-local-shell]
--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]
--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]
--require-local-shell / --no-require-local-shell: Require local shell tool [default: no-require-local-shell]
--require-web-search / --no-require-web-search: Require web search tool [default: no-require-web-search]
--require-web-fetch / --no-require-web-fetch: Require web fetch tool [default: no-require-web-fetch]
--require-apply-patch / --no-require-apply-patch: Enable apply patch tool calling [default: no-require-apply-patch]
--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]
--queue TEXT: the queue to consume [required]
--toolkit-name TEXT: Toolkit name to expose (optional)
-rr, --room-rules TEXT: Path(s) to rules files inside the room
--require-storage / --no-require-storage: Require storage toolkit [default: no-require-storage]
--require-read-only-storage / --no-require-read-only-storage: Require read-only storage toolkit [default: no-require-read-only-storage]
--require-time / --no-require-time: Enable time/datetime tools [default: require-time]
--require-uuid / --no-require-uuid: Enable UUID generation tools [default: no-require-uuid]
--use-memory TEXT: Use memories toolkit for <name> or <namespace>/<name>
--memory-model TEXT: Model name for memory LLM ingestion
--database-namespace TEXT: Database namespace (e.g. foo::bar)
--require-table-read TEXT: Require table read tool for table (repeatable)
--require-table-write TEXT: Require table write tool for table (repeatable)
--require-computer-use / --no-require-computer-use: Enable computer use [default: no-require-computer-use]
--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
--title TEXT: a display name for the agent
--description TEXT: a description for the agent
--working-dir TEXT: The default working directory for shell commands
--skill-dir TEXT: an agent skills directory
--shell-image TEXT: an image tag to use to run shell commands in
--shell-image-mount TEXT: Mount image as <image>=<mount>[:ro|rw]
--delegate-shell-token / --no-delegate-shell-token: Delegate the room token to shell tools [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]
--prompt TEXT: a prompt to use for the worker
--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: The name of a room to create the service for
--help: Show this message and exit.

`meshagent room`

Operate within a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

agent: Interact with agents and toolkits
agents: Interact with agents and toolkits
secret: Manage secrets in a room
secrets: Manage secrets in a room
queue: Use queues in a room
messaging: Send and receive messages
storage: Manage storage for a room
service: Manage services in a room
services: Manage services in a room
developer: Developer utilities for a room
database: Manage database tables in a room
memory: Manage memories in a room
container: Manage containers and images in a room
sync: Inspect and update mesh documents in a room

`meshagent room agent`

Interact with agents and toolkits Usage:

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

Options:

--help: Show this message and exit.

Commands:

invoke-tool: Invoke a specific tool from a toolkit
list-toolkits: List toolkits (and tools) available in the…

`meshagent room agent invoke-tool`

Invoke a specific tool from a toolkit Usage:

$ meshagent room agent invoke-tool [OPTIONS]

Options:

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

`meshagent room agent list-toolkits`

List toolkits (and tools) available in the room Usage:

$ meshagent room agent list-toolkits [OPTIONS]

Options:

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

`meshagent room agents`

Interact with agents and toolkits Usage:

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

Options:

--help: Show this message and exit.

Commands:

invoke-tool: Invoke a specific tool from a toolkit
list-toolkits: List toolkits (and tools) available in the…

`meshagent room agents invoke-tool`

Invoke a specific tool from a toolkit Usage:

$ meshagent room agents invoke-tool [OPTIONS]

Options:

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

`meshagent room agents list-toolkits`

List toolkits (and tools) available in the room Usage:

$ meshagent room agents list-toolkits [OPTIONS]

Options:

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

`meshagent room secret`

Manage secrets in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

oauth: Request an OAuth token from another…
request: Request a secret from another participant.
get: Fetch a stored secret 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:

$ meshagent room secret oauth [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room secret request [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room secret get [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 set`

Store a secret by ID. Usage:

$ meshagent room secret set [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room secret list [OPTIONS]

Options:

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

`meshagent room secret delete`

Delete a secret by ID. Usage:

$ meshagent room secret delete [OPTIONS] ID

Arguments:

ID: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 secrets`

Manage secrets in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

`meshagent room secrets oauth`

Request an OAuth token from another participant. Usage:

$ meshagent room secrets oauth [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 secrets request`

Request a secret from another participant. Usage:

$ meshagent room secrets request [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 secrets get`

Fetch a stored secret by ID. Usage:

$ meshagent room secrets get [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 secrets set`

Store a secret by ID. Usage:

$ meshagent room secrets set [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 secrets list`

List secrets in the room. Usage:

$ meshagent room secrets list [OPTIONS]

Options:

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

`meshagent room secrets delete`

Delete a secret by ID. Usage:

$ meshagent room secrets delete [OPTIONS] ID

Arguments:

ID: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

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

Options:

--help: Show this message and exit.

Commands:

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 send`

Send a JSON message to a room queue. Usage:

$ meshagent room queue send [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room queue send-mail [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room queue receive [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--queue TEXT: Queue name [required]
--help: Show this message and exit.

`meshagent room queue size`

Show the current size of a room queue. Usage:

$ meshagent room queue size [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--queue TEXT: Queue name [required]
--help: Show this message and exit.

`meshagent room messaging`

Send and receive messages Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List messaging-enabled participants
send: Send a direct message to a participant
broadcast: Broadcast a message to all participants

`meshagent room messaging list`

List messaging-enabled participants Usage:

$ meshagent room messaging list [OPTIONS]

Options:

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

`meshagent room messaging send`

Send a direct message to a participant Usage:

$ meshagent room messaging send [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room messaging broadcast [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--data TEXT: JSON message to broadcast [required]
--help: Show this message and exit.

`meshagent room storage`

Manage storage for a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

exists: Check whether a path exists in room storage.
cp: Copy files between local paths and room…
show: 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:

$ meshagent room storage exists [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

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

`meshagent room storage cp`

Copy files between local paths and room storage. Usage:

$ meshagent room storage cp [OPTIONS] SOURCE_PATH DEST_PATH

Arguments:

SOURCE_PATH: [required]
DEST_PATH: [required]

Options:

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

`meshagent room storage show`

Print file contents from local disk or room storage. Usage:

$ meshagent room storage show [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room storage rm [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room storage ls [OPTIONS] PATH

Arguments:

PATH: Path to list (local or room://…) [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-r: List subfolders/files recursively
--help: Show this message and exit.

`meshagent room service`

Manage services in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List services running in a room
restart: Restart a running room service by stopping…

`meshagent room service list`

List services running in a room Usage:

$ meshagent room service list [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room service restart [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--id TEXT: Service ID to restart
--name TEXT: Service name to restart
--help: Show this message and exit.

`meshagent room services`

Manage services in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List services running in a room
restart: Restart a running room service by stopping…

`meshagent room services list`

List services running in a room Usage:

$ meshagent room services list [OPTIONS]

Options:

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

`meshagent room services restart`

Restart a running room service by stopping its current container. Usage:

$ meshagent room services restart [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--id TEXT: Service ID to restart
--name TEXT: Service name to restart
--help: Show this message and exit.

`meshagent room developer`

Developer utilities for a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

watch: Stream developer logs from a room

`meshagent room developer watch`

Stream developer logs from a room Usage:

$ meshagent room developer watch [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--format [plain|json]: Output format [default: plain]
--help: Show this message and exit.

`meshagent room database`

Manage database tables in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

table: List database tables in a room.
tables: List database tables in a room.
inspect: Inspect a table schema in a room database.
install: Install required tables from a…
create: Create a room database table with optional…
drop: Drop a room database table.
add-columns: Add columns to a room database table.
drop-columns: Drop columns from a room database table.
insert: Insert records into a room database table.
merge: Upsert records into a room database table.
update: Update rows in a room database table.
delete: Delete rows from a room database table.
search: Search rows in a room database table.
sql: Execute SQL against room database tables.
optimize: Optimize a room database table.
version: List versions for a room database table.
versions: List versions for a room database table.
checkout: Check out a room database table at a…
restore: Restore a room database table to a…
index: List indexes on a room database table.
indexes: List indexes on a room database table.
index-create: Create an index on a room database table.
index-drop: Drop an index from a room database table.

`meshagent room database table`

List database tables in a room. Usage:

$ meshagent room database table [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database tables`

List database tables in a room. Usage:

$ meshagent room database tables [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database inspect`

Inspect a table schema in a room database. Usage:

$ meshagent room database inspect [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--json: Output raw schema JSON
--help: Show this message and exit.

`meshagent room database install`

Install required tables from a requirements JSON file. Usage:

$ meshagent room database install [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--file TEXT: Path to requirements JSON file
--help: Show this message and exit.

`meshagent room database create`

Create a room database table with optional schema and seed data. Usage:

$ meshagent room database create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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
-c, --columns TEXT: Comma-separated column definitions. Example: “names vector(20) null, tags list(text), meta struct(owner text, score float)”. Allowed types: int, bool, date, timestamp, float, text, binary, vector, list, struct. Vector syntax: vector(size[, element_type]). List syntax: list(element_type). Struct syntax: struct(field_name type[, …]).
--schema-json TEXT: Schema JSON as a string
--schema-file TEXT: Path to schema JSON file
--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 database drop`

Drop a room database table. Usage:

$ meshagent room database drop [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--ignore-missing: Ignore missing table
--help: Show this message and exit.

`meshagent room database add-columns`

Add columns to a room database table. Usage:

$ meshagent room database add-columns [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
-c, --columns TEXT: Comma-separated column definitions. Example: “names vector(20) null, tags list(text), meta struct(owner text, score float)”. Allowed types: int, bool, date, timestamp, float, text, 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. Supports DataType JSON including list/struct (e.g. ’{“meta”:{“type”:“struct”,“fields”:{“owner”:{“type”:“text”}}}}’).
--help: Show this message and exit.

`meshagent room database drop-columns`

Drop columns from a room database table. Usage:

$ meshagent room database drop-columns [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
-c, --column TEXT: Column to drop (repeatable)
--help: Show this message and exit.

`meshagent room database insert`

Insert records into a room database table. Usage:

$ meshagent room database insert [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--json TEXT: JSON list of records
-f, --file TEXT: Path to JSON file (list of records)
--help: Show this message and exit.

`meshagent room database merge`

Upsert records into a room database table. Usage:

$ meshagent room database merge [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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
--json TEXT: JSON records (list)
-f, --file TEXT: Path to JSON file (list)
--help: Show this message and exit.

`meshagent room database update`

Update rows in a room database table. Usage:

$ meshagent room database update [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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
--values-json TEXT: JSON object of literal values
--values-sql-json TEXT: JSON object of SQL expressions
--help: Show this message and exit.

`meshagent room database delete`

Delete rows from a room database table. Usage:

$ meshagent room database delete [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
--where TEXT: SQL WHERE clause [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database search`

Search rows in a room database table. Usage:

$ meshagent room database search [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--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 database sql`

Execute SQL against room database tables. Usage:

$ meshagent room database sql [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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
--pretty / --no-pretty: Pretty-print JSON [default: pretty]
--help: Show this message and exit.

`meshagent room database optimize`

Optimize a room database table. Usage:

$ meshagent room database optimize [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database version`

List versions for a room database table. Usage:

$ meshagent room database version [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table 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 database versions`

List versions for a room database table. Usage:

$ meshagent room database versions [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table 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 database checkout`

Check out a room database table at a specific version. Usage:

$ meshagent room database checkout [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-v, --version INTEGER: Table version [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database restore`

Restore a room database table to a specific version. Usage:

$ meshagent room database restore [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-v, --version INTEGER: Table version [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database index`

List indexes on a room database table. Usage:

$ meshagent room database index [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table 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 database indexes`

List indexes on a room database table. Usage:

$ meshagent room database indexes [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table 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 database index-create`

Create an index on a room database table. Usage:

$ meshagent room database index-create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
-c, --column TEXT: Column name [required]
--kind TEXT: vector | scalar | fts [default: scalar]
--replace / --no-replace: Replace existing index if it already exists
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room database index-drop`

Drop an index from a room database table. Usage:

$ meshagent room database index-drop [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-t, --table TEXT: Table name [required]
--name TEXT: Index name [required]
-n, --namespace TEXT: Namespace path segments (repeatable). Example: -n prod -n analytics
--help: Show this message and exit.

`meshagent room memory`

Manage memories in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

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

$ meshagent room memory list [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room 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 create`

Create a room memory store. Usage:

$ meshagent room memory create [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory drop [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory inspect [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory query [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory upsert-table [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory upsert-nodes [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory upsert-relationships [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory import [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory ingest-text [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory ingest-image [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory ingest-file [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory ingest-from-table [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory ingest-from-storage [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory recall [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory delete-entities [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory delete-relationships [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room memory optimize [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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 in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

list: List containers in a room.
stop: Stop a running container in a room.
log: Print container logs from a room.
logs: Print container logs from a room.
exec: Execute a command inside a running container.
run: Run a container inside a room.
image: Image operations
images: Image operations

`meshagent room container list`

List containers in a room. Usage:

$ meshagent room container list [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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:

$ meshagent room container stop [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--id TEXT: Container ID [required]
--help: Show this message and exit.

`meshagent room container log`

Print container logs from a room. Usage:

$ meshagent room container log [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--id TEXT: Container ID [required]
--follow / --no-follow: Stream logs [default: no-follow]
--help: Show this message and exit.

`meshagent room container logs`

Print container logs from a room. Usage:

$ meshagent room container logs [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room container exec [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--container-id TEXT: container id [required]
--command TEXT: Command to execute in the container (quoted string)
--tty / --no-tty: Allocate a TTY [default: no-tty]
--help: Show this message and exit.

`meshagent room container run`

Run a container inside a room. Usage:

$ meshagent room container run [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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-path to 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
--help: Show this message and exit.

`meshagent room container image`

Image operations Usage:

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

Options:

--help: Show this message and exit.

Commands:

build: Build a container image inside a room.
list: List container images available in a room.
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 into a room.
save: Save an OCI image archive from a room.

`meshagent room container image build`

Build a container image inside a room. Usage:

$ meshagent room container image build [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--tag TEXT: Image tag to build, e.g. repo/name:tag [required]
--context-path TEXT: Build context path inside one of the mounted paths (absolute path) [required]
--dockerfile-path TEXT: Optional Dockerfile path inside one of the mounted paths (absolute path)
--mount-room-path TEXT: Room storage mount ‘<source>:<mount>[:ro|rw]’. Example ‘/src:/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 build 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 list`

List container images available in a room. Usage:

$ meshagent room container image list [OPTIONS]

Options:

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

`meshagent room container image delete`

Delete a container image from a room. Usage:

$ meshagent room container image delete [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room container image pull [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room container image push [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 into a room. Usage:

$ meshagent room container image load [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--archive-path TEXT: Path to 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 load container is private to the participant [default: public]
--help: Show this message and exit.

`meshagent room container image save`

Save an OCI image archive from a room. Usage:

$ meshagent room container image save [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 images`

Image operations Usage:

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

Options:

--help: Show this message and exit.

Commands:

build: Build a container image inside a room.
list: List container images available in a room.
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 into a room.
save: Save an OCI image archive from a room.

`meshagent room container images build`

Build a container image inside a room. Usage:

$ meshagent room container images build [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--tag TEXT: Image tag to build, e.g. repo/name:tag [required]
--context-path TEXT: Build context path inside one of the mounted paths (absolute path) [required]
--dockerfile-path TEXT: Optional Dockerfile path inside one of the mounted paths (absolute path)
--mount-room-path TEXT: Room storage mount ‘<source>:<mount>[:ro|rw]’. Example ‘/src:/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 build 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 images list`

List container images available in a room. Usage:

$ meshagent room container images list [OPTIONS]

Options:

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

`meshagent room container images delete`

Delete a container image from a room. Usage:

$ meshagent room container images delete [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--image TEXT: Image ref/tag to delete [required]
--help: Show this message and exit.

`meshagent room container images pull`

Pull a container image into a room. Usage:

$ meshagent room container images pull [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 images push`

Push a container image from a room. Usage:

$ meshagent room container images push [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 images load`

Load an OCI image archive into a room. Usage:

$ meshagent room container images load [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--archive-path TEXT: Path to 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 load container is private to the participant [default: public]
--help: Show this message and exit.

`meshagent room container images save`

Save an OCI image archive from a room. Usage:

$ meshagent room container images save [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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 sync`

Inspect and update mesh documents in a room Usage:

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

Options:

--help: Show this message and exit.

Commands:

show: Print the full document JSON
grep: Search the document for matching content
inspect: Print the document schema JSON
create: Create a new document at a path
update: Apply a JSON patch to a document
import: Import external exports into room documents

`meshagent room sync show`

Print the full document JSON Usage:

$ meshagent room sync show [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room sync grep [OPTIONS] PATH PATTERN

Arguments:

PATH: [required]
PATTERN: Regex pattern to match [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room sync inspect [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room sync create [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--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:

$ meshagent room sync update [OPTIONS] PATH

Arguments:

PATH: [required]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
--patch TEXT: JSON patch array
--patch-file PATH: Path to JSON patch array
--help: Show this message and exit.

`meshagent room sync import`

Import external exports into room documents Usage:

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

Options:

--help: Show this message and exit.

Commands:

threads: Import Anthropic Claude GDPR conversations…

`meshagent room sync import threads`

Import Anthropic Claude GDPR conversations into room thread documents. Usage:

$ meshagent room sync import threads [OPTIONS]

Options:

--project-id TEXT: A MeshAgent project id. If empty, the activated project will be used. [required]
--room TEXT: Room name [required]
-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
--help: Show this message and exit.

Getting Started

Interfaces

Build

Deploy

Operate

Webhooks

Project Administration

UI SDKs

References

​meshagent

​meshagent version

​meshagent setup

​meshagent call

​meshagent call tool

​meshagent call agent

​meshagent call toolkit

​meshagent call schema

​meshagent auth

​meshagent auth login

​meshagent auth logout

​meshagent auth whoami

​meshagent project

​meshagent project create

​meshagent project list

​meshagent project activate

​meshagent api-key

​meshagent api-key list

​meshagent api-key create

​meshagent api-key activate

​meshagent api-key delete

​meshagent session

​meshagent session list

​meshagent session show

​meshagent token

​meshagent token generate

​meshagent webhook

​meshagent webhook create

​meshagent webhook list

​meshagent webhook delete

​meshagent service

​meshagent service spec

​meshagent service create

​meshagent service update

​meshagent service validate

​meshagent service create-template

​meshagent service update-template

​meshagent service validate-template

​meshagent service render-template

​meshagent service run

​meshagent service show

​meshagent service list

​meshagent service delete

​meshagent mcp

​meshagent mcp sse

​meshagent mcp http

​meshagent mcp stdio

​meshagent mcp http-proxy

​meshagent mcp sse-proxy

​meshagent mcp stdio-service

​meshagent secret

​meshagent secret list

​meshagent secret delete

​meshagent secret key

​meshagent secret key create

​meshagent secret key update

​meshagent secret keys

​meshagent secret keys create

​meshagent secret keys update

​meshagent secret docker

​meshagent secret docker create

​meshagent secret docker update

​meshagent secret acr

​meshagent secret acr create

​meshagent secret acr update

​meshagent secret gar

​meshagent secret gar create

​meshagent secret gar update

​meshagent helper

​meshagent helper service

​meshagent helpers

`meshagent`

`meshagent version`

`meshagent setup`

`meshagent call`

`meshagent call tool`

`meshagent call agent`

`meshagent call toolkit`

`meshagent call schema`

`meshagent auth`

`meshagent auth login`

`meshagent auth logout`

`meshagent auth whoami`

`meshagent project`

`meshagent project create`

`meshagent project list`

`meshagent project activate`

`meshagent api-key`

`meshagent api-key list`

`meshagent api-key create`

`meshagent api-key activate`

`meshagent api-key delete`

`meshagent session`

`meshagent session list`

`meshagent session show`

`meshagent token`

`meshagent token generate`

`meshagent webhook`

`meshagent webhook create`

`meshagent webhook list`

`meshagent webhook delete`

`meshagent service`

`meshagent service spec`

`meshagent service create`

`meshagent service update`

`meshagent service validate`

`meshagent service create-template`

`meshagent service update-template`

`meshagent service validate-template`

`meshagent service render-template`

`meshagent service run`

`meshagent service show`

`meshagent service list`

`meshagent service delete`

`meshagent mcp`

`meshagent mcp sse`

`meshagent mcp http`

`meshagent mcp stdio`

`meshagent mcp http-proxy`

`meshagent mcp sse-proxy`

`meshagent mcp stdio-service`

`meshagent secret`

`meshagent secret list`

`meshagent secret delete`

`meshagent secret key`

`meshagent secret key create`

`meshagent secret key update`

`meshagent secret keys`

`meshagent secret keys create`

`meshagent secret keys update`

`meshagent secret docker`

`meshagent secret docker create`

`meshagent secret docker update`

`meshagent secret acr`

`meshagent secret acr create`

`meshagent secret acr update`

`meshagent secret gar`

`meshagent secret gar create`

`meshagent secret gar update`

`meshagent helper`

`meshagent helper service`

`meshagent helpers`

`meshagent helpers service`

`meshagent rooms`

`meshagent rooms create`

`meshagent rooms delete`

`meshagent rooms update`

`meshagent rooms list`

`meshagent rooms get`

`meshagent mailbox`

`meshagent mailbox create`