# Complete reference (/cli/reference) Every command on one page, generated from the CLI itself. Start at the [overview](/cli/commands) to browse; this page is for searching and for tools. Append `.mdx` to any page for its raw Markdown — [`/cli/reference.mdx`](/cli/reference.mdx) is this page as plain text. The docs are also published as [`/llms.txt`](/llms.txt) and [`/llms-full.txt`](/llms-full.txt). ## Global options [#global-options] These apply to every command, and may be written before or after it. | Option | Description | | ---------------------- | --------------------------------------------------------------------------------- | | `-P, --profile ` | Profile to use (env: SIM\_PROFILE). | | `--endpoint ` | Sim deployment to talk to (env: SIM\_ENDPOINT). | | `-w, --workspace ` | Workspace to target (env: SIM\_WORKSPACE). | | `--output ` | Output format for this command. Accepted values: `table`, `json`, `yaml`, `text`. | ## sim login [#sim-login] Authorize this terminal and store an API key for the profile ```bash sim login [options] ``` **Options** | Option | Required | Description | | ----------------- | -------- | -------------------------------------------------------------------- | | `--scope ` | No | Key space to mint from: platform or copilot. Defaults to `platform`. | | `--no-browser` | No | Print the URL instead of opening a browser. | | `-y, --yes` | No | Overwrite an existing profile without prompting. | ## sim logout [#sim-logout] Remove the profile's stored API key ```bash sim logout [options] ``` **Options** | Option | Required | Description | | ------- | -------- | ---------------------------------------------------- | | `--all` | No | Remove the profile entirely, including its settings. | ## sim whoami [#sim-whoami] Show the resolved profile and where each setting came from ```bash sim whoami ``` ## sim profiles [#sim-profiles] List the profiles defined in the config and credentials files ```bash sim profiles ``` Also available as `sim profile`. ## sim configure [#sim-configure] Set a profile's endpoint, default workspace, or output format ```bash sim configure [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------ | | `--set-endpoint ` | No | Sim deployment to talk to. | | `--set-workspace ` | No | Default workspace for workspace-scoped commands. | | `--set-output ` | No | Default output format (table \| json \| yaml \| text). | | `--unset ` | No | Remove settings (endpoint, workspace, output). | ## sim audit-logs [#sim-audit-logs] Also spelled `sim audit-log`. ### sim audit-logs get [#sim-audit-logs-get] Get Audit Log ```bash sim audit-logs get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Audit-log entry identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | -------------------------------------------- | | `--organization ` | Yes | Organization ID (personal API key required). | ### sim audit-logs list [#sim-audit-logs-list] List Audit Logs ```bash sim audit-logs list [options] ``` **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--action ` | No | Filter by exact action name. | | `--resource-type ` | No | Filter by resource type. Accepts a comma-separated set; members are trimmed and deduplicated, and member order affects neither the result nor the cursor. | | `--resource-id ` | No | Filter by exact resource identifier. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--include-departed` | No | Include actions by users who have left the organization. | | `--no-include-departed` | No | Send --include-departed as false. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--organization ` | Yes | Organization ID (personal API key required). | | `--actor-email ` | No | Filter by actor email address. | | `--all-workspaces` | No | Do not filter to the configured workspace (personal API key required for account-wide access). | ## sim billing [#sim-billing] ### sim billing status [#sim-billing-status] Show billing status and current-period credit usage ```bash sim billing status [options] ``` **Options** | Option | Required | Description | | ------------------ | -------- | ---------------------------------------------------------------------------------------------- | | `--all-workspaces` | No | Do not filter to the configured workspace (personal API key required for account-wide access). | ### sim billing logs [#sim-billing-logs] List credit usage events ```bash sim billing logs [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--source ` | No | Filter by usage source; sim-chat combines Copilot and workspace chat. Accepted values: `workflow`, `wand`, `sim-chat`, `mcp_copilot`, `mothership_block`, `knowledge-base`, `voice-input`, `enrichment`, `voice-output`. | | `--period ` | No | Billing period. Accepted values: `1d`, `7d`, `30d`, `all`, `custom`. | | `--start-date ` | No | Custom period start (ISO 8601). | | `--end-date ` | No | Custom period end (ISO 8601). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--all-workspaces` | No | Do not filter to the configured workspace (personal API key required for account-wide access). | ## sim credentials [#sim-credentials] Also spelled `sim credential`. ### sim credentials delete [#sim-credentials-delete] Disconnect Credential ```bash sim credentials delete [options] ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ------------------------- | | `credentialId` | Yes | Credential to disconnect. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim credentials providers list [#sim-credentials-providers-list] List Credential Providers ```bash sim credentials providers list [options] ``` **Options** | Option | Required | Description | | ------------------ | -------- | ---------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the credential provider name. | ### sim credentials list [#sim-credentials-list] List Credentials ```bash sim credentials list [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ---------------------------------------------------------------------------------------- | | `--type ` | No | Restrict results to this credential type. Accepted values: `oauth`, `service_account`. | | `--provider-id ` | No | Restrict results to credentials for this integration provider. | | `--search ` | No | Case-insensitive substring match against the credential display name. | | `--sort-by ` | No | Field used to sort the result. Accepted values: `displayName`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim credentials create [#sim-credentials-create] Create a service-account credential using its discovered provider schema ```bash sim credentials create [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | --------------------------------------------------- | | `providerId` | Yes | Service-account provider to create a credential for | **Options** | Option | Required | Description | | ----------------------------- | -------- | --------------------------------------------------------------------- | | `--name ` | Yes | Name shown for the credential in Sim. | | `--credentials ` | Yes | Provider credentials as JSON (or @path / @- to read a file or stdin). | | `--description ` | No | Optional credential description. | | `--id ` | No | Client-generated credential ID when provider discovery requires it. | ### sim credentials connect [#sim-credentials-connect] Create a short-lived link for connecting an OAuth provider ```bash sim credentials connect [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ------------------------- | | `providerId` | Yes | OAuth provider to connect | **Options** | Option | Required | Description | | ---------------------- | -------- | ----------------------------------------- | | `--name ` | Yes | Name shown for the new credential in Sim. | ### sim credentials reconnect [#sim-credentials-reconnect] Create a short-lived link for reconnecting an OAuth credential ```bash sim credentials reconnect ``` **Arguments** | Argument | Required | Description | | -------------- | -------- | ----------------------------------------- | | `credentialId` | Yes | Existing OAuth credential to re-authorize | ## sim custom-tools [#sim-custom-tools] Also spelled `sim custom-tool`. ### sim custom-tools create [#sim-custom-tools-create] Create Custom Tool ```bash sim custom-tools create [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--title ` | Yes | Display title, unique within the workspace. | | `--schema ` | Yes | OpenAI function schema: \{"type":"function","function":\{"name":"...","parameters":\{"type":"object","properties":\{}}}} (JSON, or @path / @- to read a file or stdin). | | `--code ` | Yes | Tool implementation executed in the sandboxed function runtime. | ### sim custom-tools delete [#sim-custom-tools-delete] Delete Custom Tool ```bash sim custom-tools delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------ | | `id` | Yes | Unique custom tool identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim custom-tools get [#sim-custom-tools-get] Get Custom Tool ```bash sim custom-tools get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------ | | `id` | Yes | Unique custom tool identifier. | ### sim custom-tools list [#sim-custom-tools-list] List Custom Tools ```bash sim custom-tools list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the tool title. | | `--sort-by ` | No | Field used to sort the result. Accepted values: `title`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim custom-tools update [#sim-custom-tools-update] Update Custom Tool ```bash sim custom-tools update [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------ | | `id` | Yes | Unique custom tool identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--title ` | No | New display title for the tool. | | `--schema ` | No | OpenAI function schema: \{"type":"function","function":\{"name":"...","parameters":\{"type":"object","properties":\{}}}} (JSON, or @path / @- to read a file or stdin). | | `--code ` | No | Replacement tool implementation. | ## sim files [#sim-files] Also spelled `sim file`. ### sim files batch-delete [#sim-files-batch-delete] Delete several files at once ```bash sim files batch-delete [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------------------------------- | | `--file-ids ` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line). | | `-y, --yes` | No | Skip the confirmation. | ### sim files create [#sim-files-create] Create File ```bash sim files create [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | File name, including its extension. Path separators and dot segments are rejected. | | `--content-type ` | No | MIME type. When omitted, it is inferred from the file extension. | | `--folder ` | No | Folder path; the leading / is optional. | | `--content ` | No | Initial file content. Omit or send an empty string for a zero-byte file. The 70,000,000-character bound guards the JSON envelope; the decoded bytes must be at most 50 MiB, and a longer base64 payload is rejected with `413`. Use an upload session for anything larger. | | `--encoding ` | No | Encoding of the content field. Accepted values: `utf-8`, `base64`. | ### sim files folders create [#sim-files-folders-create] Create a file folder at a path ```bash sim files folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | ### sim files folders delete [#sim-files-folders-delete] Delete Folder ```bash sim files folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | No | Skip the confirmation. | ### sim files folders list [#sim-files-folders-list] List Folders ```bash sim files folders list [options] ``` Also available as `sim files folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim files folders move [#sim-files-folders-move] Rename or move a file folder ```bash sim files folders move ``` Also available as `sim files folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | | `destination` | Yes | Folder path; the leading / is optional | ### sim files delete [#sim-files-delete] Delete File ```bash sim files delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim files describe [#sim-files-describe] Show file metadata and sharing status ```bash sim files describe [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | No | Which lifecycle set to read from: `active` (default) resolves live files only and returns `404` for a file a `DELETE` soft-deleted; `archived` also resolves soft-deleted files, so metadata stays readable before `POST /files/{fileId}/restore`. Authorization is identical for both. Accepted values: `active`, `archived`. | ### sim files share get [#sim-files-share-get] Show a file’s share settings ```bash sim files share get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | ### sim files share set [#sim-files-share-set] Enable or disable sharing for a file ```bash sim files share set [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ----------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--is-active ` | Yes | Whether the share should resolve. Disabling preserves the token and the whole access configuration, so re-enabling restores the share as it was; enabling rewrites the credentials the resulting mode does not use. Accepted values: `true`, `false`. | | `--auth-type ` | No | How access to the share is gated. The stored mode is kept when omitted. Enabling `public` clears the stored password and empties `allowedEmails`; `password` empties `allowedEmails`; `email` and `sso` clear the stored password. Accepted values: `public`, `password`, `email`, `sso`. | | `--password ` | No | Password for a password-gated share. Kept when omitted; enabling `password` with neither a supplied nor a stored password is a 400. | | `--allowed-emails ` | No | Allowed addresses or `@domain` patterns for email and SSO shares. Kept when omitted; enabling `email` or `sso` with an empty resulting list is a 400. (space-separated, or @path / @- with one value per line). | ### sim files list [#sim-files-list] List Files ```bash sim files list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--folder ` | No | Folder path; the leading / is optional. | | `--scope ` | No | Which lifecycle set to list: `active` (default) for live files, `archived` for files a `DELETE` soft-deleted. `folderPath` resolves against active folders only, so pairing it with `scope=archived` returns an empty page when the containing folder was archived too. Accepted values: `active`, `archived`. | | `--search ` | No | Case-insensitive substring match against the file name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `size`, `uploadedAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim files move [#sim-files-move] Move files into another folder ```bash sim files move [options] ``` Also available as `sim files mv`. **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------------------------------------------- | | `--file-ids ` | Yes | File identifiers to update. (space-separated, or @path / @- with one value per line). | | `--to ` | No | Destination folder path; omit for root. | ### sim files rename [#sim-files-rename] Rename a file ```bash sim files rename [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | ---------------- | -------- | --------------------------------------- | | `--name ` | Yes | New file name, including its extension. | ### sim files restore create [#sim-files-restore-create] Restore File ```bash sim files restore create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | ### sim files set-content [#sim-files-set-content] Replace a file’s contents ```bash sim files set-content [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ---------------- | | `fileId` | Yes | File identifier. | **Options** | Option | Required | Description | | -------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--content ` | Yes | Complete replacement content for the file. The 70,000,000-character bound guards the JSON envelope; the decoded bytes must be at most 50 MiB, and a longer base64 payload is rejected with `413`. | | `--encoding ` | No | Content encoding. Accepted values: `utf-8`, `base64`. | ### sim files upload [#sim-files-upload] Upload a file to the workspace ```bash sim files upload [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------- | | `path` | Yes | Local file to upload | **Options** | Option | Required | Description | | ----------------- | -------- | ---------------------------------------- | | `--folder ` | No | Destination folder path (defaults to /). | | `--name ` | No | Store it under a different name. | ### sim files get [#sim-files-get] Get a file’s content ```bash sim files get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------- | | `fileId` | Yes | File whose content to read | **Options** | Option | Required | Description | | -------------------------- | -------- | --------------------------------------------- | | `-o, --output-file ` | No | Write content to a file instead of stdout. | | `--force` | No | Overwrite --output-file if it already exists. | ### sim files ls [#sim-files-ls] List file resources and child folders together ```bash sim files ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | ----------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `100`. | ### sim files mkdir [#sim-files-mkdir] Create a file directory at a path ```bash sim files mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim knowledge [#sim-knowledge] Also spelled `sim kb`. ### sim knowledge documents batch-update [#sim-knowledge-documents-batch-update] Enable or disable every matching document ```bash sim knowledge documents batch-update [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | -------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------- | | `--operation ` | Yes | Whether the selected documents become enabled or disabled for search. Accepted values: `enable`, `disable`. | | `--document ` | No | Documents to update, by identifier. (space-separated, or @path / @- with one value per line). | | `--select-all` | No | Apply to every document in the knowledge base. | | `--enabled-filter ` | No | With `selectAll`, restrict the update to documents in this state. Accepted values: `all`, `enabled`, `disabled`. | ### sim knowledge documents delete [#sim-knowledge-documents-delete] Delete Document ```bash sim knowledge documents delete [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim knowledge documents get [#sim-knowledge-documents-get] Get Document ```bash sim knowledge documents get ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ------------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | ### sim knowledge documents list [#sim-knowledge-documents-list] List Documents ```bash sim knowledge documents list [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | --------------------------------- | | `knowledgeBaseId` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | -------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--search ` | No | Case-insensitive substring match against the document filename. | | `--enabled-filter ` | No | Filter by whether documents are enabled for search. Accepted values: `all`, `enabled`, `disabled`. | | `--sort-by ` | No | Field used to sort the result. Sorting by `filename` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `filename`, `fileSize`, `tokenCount`, `chunkCount`, `uploadedAt`, `processingStatus`, `enabled`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--tag-filters ` | No | A JSON-encoded array of at most 10 tag filters, using the same display-name shape as knowledge search: `[{"tagName":"category","operator":"eq","value":"billing"}]`. Every filter must hold, including two that name the same tag. A name that is not defined in this knowledge base is rejected, never ignored. | ### sim knowledge documents update [#sim-knowledge-documents-update] Update Document ```bash sim knowledge documents update [options] ``` **Arguments** | Argument | Required | Description | | ------------ | -------- | ------------------------------------- | | `id` | Yes | Unique knowledge base identifier. | | `documentId` | Yes | Unique knowledge document identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filename ` | No | New filename for the document. | | `--enabled` | No | Whether the document participates in search. Disabling keeps it indexed. | | `--no-enabled` | No | Send --enabled as false. | | `--tag1 ` | No | New value for tag slot 1. | | `--tag2 ` | No | New value for tag slot 2. | | `--tag3 ` | No | New value for tag slot 3. | | `--tag4 ` | No | New value for tag slot 4. | | `--tag5 ` | No | New value for tag slot 5. | | `--tag6 ` | No | New value for tag slot 6. | | `--tag7 ` | No | New value for tag slot 7. | | `--number1 ` | No | New value for number tag slot 1. | | `--number2 ` | No | New value for number tag slot 2. | | `--number3 ` | No | New value for number tag slot 3. | | `--number4 ` | No | New value for number tag slot 4. | | `--number5 ` | No | New value for number tag slot 5. | | `--date1 ` | No | New value for date tag slot 1, formatted YYYY-MM-DD. | | `--date2 ` | No | New value for date tag slot 2, formatted YYYY-MM-DD. | | `--boolean1` | No | New value for boolean tag slot 1. | | `--no-boolean1` | No | Send --boolean1 as false. | | `--boolean2` | No | New value for boolean tag slot 2. | | `--no-boolean2` | No | Send --boolean2 as false. | | `--boolean3` | No | New value for boolean tag slot 3. | | `--no-boolean3` | No | Send --boolean3 as false. | | `--retry-processing` | No | Requeue a failed or stuck document for processing. Send it alone — no other field may accompany it — and it answers with a queue acknowledgement rather than the document. | | `--no-retry-processing` | No | Send --retry-processing as false. | ### sim knowledge documents upload [#sim-knowledge-documents-upload] Upload a document to a knowledge base ```bash sim knowledge documents upload [options] ``` **Arguments** | Argument | Required | Description | | ----------------- | -------- | ----------------------------- | | `knowledgeBaseId` | Yes | Knowledge base to upload into | | `path` | Yes | Local file to upload | **Options** | Option | Required | Description | | ------------------ | -------- | ------------------------------------------ | | `--name ` | No | Store it under a different name. | | `--tag ` | No | Document tags, in tag1 through tag7 order. | | `--recipe ` | No | Document processing recipe. | | `--lang ` | No | Document language code. | ### sim knowledge create [#sim-knowledge-create] Create Knowledge Base ```bash sim knowledge create [options] ``` **Options** | Option | Required | Description | | --------------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Human-readable knowledge base name. | | `--description ` | No | Optional knowledge base description. | | `--chunking-config ` | No | Chunking configuration; defaults are applied when omitted. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path; the leading / is optional. | ### sim knowledge folders create [#sim-knowledge-folders-create] Create a knowledge folder at a path ```bash sim knowledge folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | ### sim knowledge folders delete [#sim-knowledge-folders-delete] Delete Folder ```bash sim knowledge folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | No | Skip the confirmation. | ### sim knowledge folders list [#sim-knowledge-folders-list] List Folders ```bash sim knowledge folders list [options] ``` Also available as `sim knowledge folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim knowledge folders move [#sim-knowledge-folders-move] Rename or move a knowledge folder ```bash sim knowledge folders move ``` Also available as `sim knowledge folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | | `destination` | Yes | Folder path; the leading / is optional | ### sim knowledge delete [#sim-knowledge-delete] Delete Knowledge Base ```bash sim knowledge delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------- | | `id` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim knowledge get [#sim-knowledge-get] Get Knowledge Base ```bash sim knowledge get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------- | | `id` | Yes | Unique knowledge base identifier. | ### sim knowledge list [#sim-knowledge-list] List Knowledge Bases ```bash sim knowledge list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--folder ` | No | Folder path; the leading / is optional. | | `--search ` | No | Case-insensitive substring match against the resource name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim knowledge tags list [#sim-knowledge-tags-list] List Tags ```bash sim knowledge tags list ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------- | | `id` | Yes | Unique knowledge base identifier. | ### sim knowledge search [#sim-knowledge-search] Search Knowledge ```bash sim knowledge search [options] ``` **Options** | Option | Required | Description | | -------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--kb ` | Yes | Knowledge base ID (repeatable) (space-separated, or @path / @- with one value per line). | | `--query ` | No | Text to search for. | | `--top-k ` | No | Maximum number of search results to return. Must be a whole number between 1 and 100; the boundary schema only bounds the range, so a fractional value is admitted here and then rejected with 400 during search. | | `--tag-filters ` | No | Tag filters as \[\{"tagName":"...","operator":"...","value":"..."}] (JSON, or @path / @- to read a file or stdin). | | `--search-mode ` | No | Search algorithm. Accepted values: `vector`, `hybrid`. | | `--reranker-enabled` | No | Re-order retrieved chunks with a reranking model before truncating to `topK`. Ignored for a tag-only search, and billed as an additional search unit. Reranking is best-effort — a provider failure falls back to vector ordering, so check `rerankerStatus` on the response. | | `--no-reranker-enabled` | No | Send --reranker-enabled as false. | | `--reranker-model ` | No | Reranking model to use when `rerankerEnabled` is true. Defaults to `rerank-v4.0-fast`. Accepted values: `rerank-v4.0-pro`, `rerank-v4.0-fast`, `rerank-v3.5`. | | `--reranker-input-count ` | No | How many candidate chunks to retrieve before reranking. Defaults to four times `topK`, capped at 100. A larger pool costs more retrieval work but gives the reranker more to choose from. | ### sim knowledge update [#sim-knowledge-update] Update Knowledge Base ```bash sim knowledge update [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------- | | `id` | Yes | Unique knowledge base identifier. | **Options** | Option | Required | Description | | --------------------------------- | -------- | ----------------------------------------------------------------------------------- | | `--name ` | No | New knowledge base name. | | `--description ` | No | New knowledge base description. | | `--chunking-config ` | No | New document chunking configuration. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path; the leading / is optional. | ### sim knowledge mv [#sim-knowledge-mv] Move a knowledge base to a folder ```bash sim knowledge mv ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `id` | Yes | Unique knowledge base identifier. | | `folder` | Yes | Folder path; the leading / is optional | ### sim knowledge ls [#sim-knowledge-ls] List knowledge resources and child folders together ```bash sim knowledge ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | ----------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `100`. | ### sim knowledge mkdir [#sim-knowledge-mkdir] Create a knowledge directory at a path ```bash sim knowledge mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim logs [#sim-logs] Also spelled `sim log`. ### sim logs get [#sim-logs-get] Show run diagnostics ```bash sim logs get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | --------- | -------- | ------------------------------------------------------------------------- | | `--trace` | No | Show expanded trace spans with inputs, outputs, errors, timing, and cost. | ### sim logs list [#sim-logs-list] List Logs ```bash sim logs list [options] ``` **Options** | Option | Required | Description | | --------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | No | Comma-separated workflow identifiers to include. An empty entry is rejected. (space-separated, or @path / @- with one value per line). | | `--trigger ` | No | Comma-separated trigger types to include. An empty entry is rejected. Values are matched exactly and are case-sensitive — every recorded trigger is lowercase, so `API` matches nothing while `api` matches. The vocabulary is open: it covers the core trigger types (`manual`, `api`, `schedule`, `chat`, `webhook`, `mcp`, `copilot`, `workflow`, `custom_block`) and the provider id of any webhook trigger (`slack`, `gmail`, `github`, …), so an unrecognized member is not rejected — it selects no runs. The literal value `all` is a sentinel that disables this filter entirely, so a list containing it returns runs of every trigger type; no real trigger type is named `all`. (space-separated, or @path / @- with one value per line). | | `--level ` | No | Severity level to include. Accepted values: `info`, `error`. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--min-duration-ms ` | No | Minimum total execution duration in milliseconds. Whole milliseconds from 0 to 2147483647; the stored duration is a 32-bit integer, so a fractional or out-of-range bound is rejected. | | `--max-duration-ms ` | No | Maximum total execution duration in milliseconds. Whole milliseconds from 0 to 2147483647; the stored duration is a 32-bit integer, so a fractional or out-of-range bound is rejected. | | `--min-cost ` | No | Minimum execution cost in USD, from 0 to 1000000. A run is never charged a negative amount, so a negative bound is rejected rather than treated as a filter that matches every run. | | `--max-cost ` | No | Maximum execution cost in USD, from 0 to 1000000. A run is never charged a negative amount, so a negative bound is rejected rather than treated as a filter that matches every run. | | `--model ` | No | AI model used during execution. | | `--details ` | No | Response detail level. Accepted values: `basic`, `full`. | | `--include-trace-spans` | No | Include trace spans in JSON or YAML output (implies full detail). | | `--include-final-output` | No | Include final output in JSON or YAML output (implies full detail). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--order ` | No | Sort direction by execution start time. This list is sortable only by execution start time, so it takes `order` in place of `sortBy`/`sortOrder`, which it rejects. Accepted values: `asc`, `desc`. | | `--run-id ` | No | Exact run identifier to match. | | `--folder ` | No | Folder path; the leading / is optional (space-separated, or @path / @- with one value per line). | ## sim mcp-servers [#sim-mcp-servers] Also spelled `sim mcp-server`. ### sim mcp-servers create [#sim-mcp-servers-create] Create MCP Server ```bash sim mcp-servers create [options] ``` **Options** | Option | Required | Description | | ------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Server display name. | | `--description ` | No | Optional server description. | | `--transport ` | No | Transport used to communicate with the server. Applied server-side as `streamable-http` when omitted on create. Accepted values: `streamable-http`. | | `--url ` | Yes | Absolute HTTP or HTTPS endpoint URL without `{{ENV_VAR}}` references. It determines server identity and is immutable: delete and recreate the server to change endpoints. | | `--auth-type ` | No | Authentication method. When omitted, and no `headers` are sent, registration probes the endpoint once to classify it, falling back to `headers` when the probe fails or the server does not advertise OAuth. A server publishing RFC 9728 metadata is therefore stored as `oauth`, and headers configured afterwards will not authenticate — send this field explicitly to pin the method. Accepted values: `none`, `headers`, `oauth`. | | `--headers ` | No | Write-only request headers sent to the server. Replaced wholesale rather than merged on update: sending this field drops every stored header it does not repeat. (JSON, or @path / @- to read a file or stdin). | | `--timeout ` | No | Per-request timeout in milliseconds. Applied server-side as 30000 when omitted on create. | | `--retries ` | No | Number of retries per request. Applied server-side as 3 when omitted on create. | | `--enabled` | No | Whether the server tools are available to workflows. Applied server-side as true when omitted on create. | | `--no-enabled` | No | Send --enabled as false. | | `--oauth-client-id ` | No | Pre-registered OAuth client identifier. Changing it on update revokes the stored OAuth grant and forces reauthorization. | | `--oauth-client-secret ` | No | Write-only pre-registered OAuth client secret. Sending it on update as null or a new value revokes the stored OAuth grant and forces reauthorization, as does switching away from OAuth authentication. | ### sim mcp-servers delete [#sim-mcp-servers-delete] Delete MCP Server ```bash sim mcp-servers delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ----------------------------- | | `id` | Yes | Unique MCP server identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim mcp-servers get [#sim-mcp-servers-get] Get MCP Server ```bash sim mcp-servers get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ----------------------------- | | `id` | Yes | Unique MCP server identifier. | ### sim mcp-servers list [#sim-mcp-servers-list] List MCP Servers ```bash sim mcp-servers list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the server name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim mcp-servers tools list [#sim-mcp-servers-tools-list] List MCP Server Tools ```bash sim mcp-servers tools list [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ----------------------------- | | `id` | Yes | Unique MCP server identifier. | **Options** | Option | Required | Description | | -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--refresh` | No | Bypass the short-lived per-workspace tool cache and reconnect under your own credentials. A cached result reflects whichever workspace member last ran discovery, so this is the only way to pick up a tool added since then; it costs a live round trip. | | `--no-refresh` | No | Send --refresh as false. | ### sim mcp-servers update [#sim-mcp-servers-update] Update MCP Server ```bash sim mcp-servers update [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ----------------------------- | | `id` | Yes | Unique MCP server identifier. | **Options** | Option | Required | Description | | ------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--name ` | No | Server display name. | | `--description ` | No | Optional server description. | | `--transport ` | No | Transport used to communicate with the server. Applied server-side as `streamable-http` when omitted on create. Accepted values: `streamable-http`. | | `--url ` | No | Immutable server URL. When provided, it must equal the current URL; use delete and create to change endpoints. | | `--auth-type ` | No | Authentication method. When omitted, and no `headers` are sent, registration probes the endpoint once to classify it, falling back to `headers` when the probe fails or the server does not advertise OAuth. A server publishing RFC 9728 metadata is therefore stored as `oauth`, and headers configured afterwards will not authenticate — send this field explicitly to pin the method. Accepted values: `none`, `headers`, `oauth`. | | `--headers ` | No | Write-only request headers sent to the server. Replaced wholesale rather than merged on update: sending this field drops every stored header it does not repeat. (JSON, or @path / @- to read a file or stdin). | | `--timeout ` | No | Per-request timeout in milliseconds. Applied server-side as 30000 when omitted on create. | | `--retries ` | No | Number of retries per request. Applied server-side as 3 when omitted on create. | | `--enabled` | No | Whether the server tools are available to workflows. Applied server-side as true when omitted on create. | | `--no-enabled` | No | Send --enabled as false. | | `--oauth-client-id ` | No | Pre-registered OAuth client identifier. Changing it on update revokes the stored OAuth grant and forces reauthorization. | | `--oauth-client-secret ` | No | Write-only pre-registered OAuth client secret. Sending it on update as null or a new value revokes the stored OAuth grant and forces reauthorization, as does switching away from OAuth authentication. | ## sim secrets [#sim-secrets] Also spelled `sim secret`. ### sim secrets delete [#sim-secrets-delete] Delete Secret ```bash sim secrets delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------- | | `name` | Yes | Secret to create, replace, or delete. | **Options** | Option | Required | Description | | ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | Yes | Whether the secret belongs to the workspace or to the caller. A personal secret belongs to the caller across every workspace, not to one workspace. Accepted values: `workspace`, `personal`. | | `-y, --yes` | No | Skip the confirmation. | ### sim secrets list [#sim-secrets-list] List Secrets ```bash sim secrets list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | No | Restrict results to one ownership scope. Accepted values: `workspace`, `personal`. | | `--search ` | No | Case-insensitive substring match against the secret name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim secrets set [#sim-secrets-set] Create or replace a named secret ```bash sim secrets set [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------------- | | `name` | Yes | Secret name, as referenced in workflows | **Options** | Option | Required | Description | | ----------------- | -------- | ----------------------------------------------------------------- | | `--scope ` | Yes | Secret ownership scope. Accepted values: `workspace`, `personal`. | | `--value ` | No | Secret value; visible to shell history when supplied directly. | ## sim skills [#sim-skills] Also spelled `sim skill`. ### sim skills create [#sim-skills-create] Create Skill ```bash sim skills create [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | ---------------------------------------------------------------------------------- | | `--name ` | Yes | Kebab-case name, unique within the workspace and not reserved by a built-in skill. | | `--description ` | Yes | One-line summary of when the skill applies. | | `--content ` | Yes | Skill body containing the instructions given to the agent. | ### sim skills delete [#sim-skills-delete] Delete Skill ```bash sim skills delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `id` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim skills get [#sim-skills-get] Get Skill ```bash sim skills get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `id` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | ### sim skills list [#sim-skills-list] List Skills ```bash sim skills list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--search ` | No | Case-insensitive substring match against the skill name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim skills update [#sim-skills-update] Update Skill ```bash sim skills update [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------------------------------------------------------------------- | | `id` | Yes | Unique skill identifier. A built-in skill is `builtin-` followed by its name, for example `builtin-research`. | **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------------------------- | | `--name ` | No | New kebab-case skill name. | | `--description ` | No | New one-line summary of when the skill applies. | | `--content ` | No | Replacement skill body. | ## sim tables [#sim-tables] Also spelled `sim table`. ### sim tables columns create [#sim-tables-columns-create] Add Column ```bash sim tables columns create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ------------------------------------------------------------------------ | | `--column ` | Yes | Column definition to add. (JSON, or @path / @- to read a file or stdin). | ### sim tables columns delete [#sim-tables-columns-delete] Delete Column ```bash sim tables columns delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ----------------------------- | | `--column-name ` | Yes | Name of the column to delete. | | `-y, --yes` | No | Skip the confirmation. | ### sim tables columns run [#sim-tables-columns-run] Run a column’s workflow ```bash sim tables columns run [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--group-ids ` | Yes | Workflow or enrichment groups to run. (space-separated, or @path / @- with one value per line). | | `--run-mode ` | No | Whether to run all or only incomplete cells. Accepted values: `all`, `incomplete`. | | `--row-ids ` | No | Explicit row subset to run. (space-separated, or @path / @- with one value per line). | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--exclude-row-ids ` | No | Rows excluded from a select-all run scope. (space-separated, or @path / @- with one value per line). | | `--limit ` | No | Optional cap on eligible rows to run. (JSON, or @path / @- to read a file or stdin). | ### sim tables columns update [#sim-tables-columns-update] Update Column ```bash sim tables columns update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------- | | `--column-name ` | Yes | Current name of the column to update. | | `--updates ` | Yes | Mutable column fields. (JSON, or @path / @- to read a file or stdin). | ### sim tables groups create [#sim-tables-groups-create] Add Workflow Group ```bash sim tables groups create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | -------------------------------- | -------- | ------------------------------------------------------------------------------------------ | | `--group ` | Yes | Workflow or enrichment producer definition. (JSON, or @path / @- to read a file or stdin). | | `--output-columns ` | Yes | Columns created for producer outputs. (JSON, or @path / @- to read a file or stdin). | | `--auto-run` | No | Whether to schedule existing rows after group creation. | | `--no-auto-run` | No | Send --auto-run as false. | ### sim tables groups delete [#sim-tables-groups-delete] Delete Workflow Group ```bash sim tables groups delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | -------------------- | -------- | ------------------------- | | `--group-id ` | Yes | Workflow group to delete. | | `-y, --yes` | No | Skip the confirmation. | ### sim tables groups list [#sim-tables-groups-list] List Workflow Groups ```bash sim tables groups list ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables groups update [#sim-tables-groups-update] Update Workflow Group ```bash sim tables groups update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--group-id ` | Yes | Workflow group to update. | | `--workflow-id ` | No | Replacement backing workflow identifier. | | `--name ` | No | Replacement workflow-group display name. | | `--dependencies ` | No | Replacement input dependencies. (JSON, or @path / @- to read a file or stdin). | | `--outputs ` | No | Replacement producer outputs. (JSON, or @path / @- to read a file or stdin). | | `--new-output-columns ` | No | Columns to add for new outputs. (JSON, or @path / @- to read a file or stdin). | | `--mapping-updates ` | No | Existing output-column mapping changes. (JSON, or @path / @- to read a file or stdin). | | `--input-mappings ` | No | Replacement workflow input mappings. (JSON, or @path / @- to read a file or stdin). | | `--deployment-mode ` | No | Replacement workflow execution mode. Accepted values: `live`, `deployed`. | | `--type ` | No | Workflow-group producer type. Must match the group's stored type — a group's producer cannot be changed after creation. Accepted values: `manual`, `enrichment`. | | `--auto-run` | No | Replacement automatic-run setting. | | `--no-auto-run` | No | Send --auto-run as false. | ### sim tables exports cancel [#sim-tables-exports-cancel] Cancel Table Export ```bash sim tables exports cancel ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `exportId` | Yes | Unique table-export identifier. | ### sim tables exports create [#sim-tables-exports-create] Create Table Export ```bash sim tables exports create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------ | -------- | --------------------------------------------------- | | `--format ` | No | Export file format. Accepted values: `csv`, `json`. | ### sim tables exports get [#sim-tables-exports-get] Get Table Export ```bash sim tables exports get ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `exportId` | Yes | Unique table-export identifier. | ### sim tables exports download [#sim-tables-exports-download] Get the download URL for a finished export ```bash sim tables exports download ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `exportId` | Yes | Unique table-export identifier. | ### sim tables imports cancel [#sim-tables-imports-cancel] Cancel Table Import ```bash sim tables imports cancel ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `importId` | Yes | Unique table-import identifier. | ### sim tables imports get [#sim-tables-imports-get] Get Table Import ```bash sim tables imports get ``` **Arguments** | Argument | Required | Description | | ---------- | -------- | ------------------------------- | | `importId` | Yes | Unique table-import identifier. | ### sim tables cancel-runs [#sim-tables-cancel-runs] Stop every running column job ```bash sim tables cancel-runs [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--scope ` | Yes | Whether to cancel across the table or one row. Accepted values: `all`, `row`. | | `--row-id ` | No | Row whose runs should be canceled for row scope. | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--exclude-row-ids ` | No | Rows excluded from an all-scope cancellation. (space-separated, or @path / @- with one value per line). | ### sim tables create [#sim-tables-create] Create Table ```bash sim tables create [options] ``` **Options** | Option | Required | Description | | ------------------------ | -------- | -------------------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Identifier: letters, numbers, and underscores; cannot start with a number. | | `--description ` | No | Optional table description. | | `--schema ` | Yes | Table schema: \{"columns":\[\{"name":"email","type":"string"}]} (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path; the leading / is optional. | ### sim tables folders create [#sim-tables-folders-create] Create a table folder at a path ```bash sim tables folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | ### sim tables folders delete [#sim-tables-folders-delete] Delete Folder ```bash sim tables folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | No | Skip the confirmation. | ### sim tables folders list [#sim-tables-folders-list] List Folders ```bash sim tables folders list [options] ``` Also available as `sim tables folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim tables folders move [#sim-tables-folders-move] Rename or move a table folder ```bash sim tables folders move ``` Also available as `sim tables folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | | `destination` | Yes | Folder path; the leading / is optional | ### sim tables rows create [#sim-tables-rows-create] Create Rows ```bash sim tables rows create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | -------------------------------------------------------------------------------------- | | `--data ` | No | One row keyed by column name (JSON, or @path / @-; choose exactly one body flag). | | `--rows ` | No | Several rows keyed by column name (JSON, or @path / @-; choose exactly one body flag). | ### sim tables rows delete [#sim-tables-rows-delete] Delete Row ```bash sim tables rows delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------- | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim tables rows batch-delete [#sim-tables-rows-batch-delete] Delete rows matching a filter, or an explicit list of ids ```bash sim tables rows batch-delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--row ` | No | Explicit row identifiers to delete. (space-separated, or @path / @- with one value per line). | | `-y, --yes` | No | Skip the confirmation. | ### sim tables rows find [#sim-tables-rows-find] Find rows matching a predicate ```bash sim tables rows find [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--q ` | Yes | Value to find. | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--sort ` | No | Ordered sort keys: \[\{"field":"createdAt","direction":"desc"}] (direction: asc or desc) (JSON, or @path / @- to read a file or stdin). | ### sim tables rows get [#sim-tables-rows-get] Get Row ```bash sim tables rows get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------- | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | ### sim tables rows list [#sim-tables-rows-list] List Rows ```bash sim tables rows list [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim tables rows query [#sim-tables-rows-query] Query Rows ```bash sim tables rows query [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filter ` | No | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--sort ` | No | Ordered sort keys: \[\{"field":"createdAt","direction":"desc"}] (direction: asc or desc) (JSON, or @path / @- to read a file or stdin). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim tables rows enrich [#sim-tables-rows-enrich] Run one row’s enrichment group ```bash sim tables rows enrich ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------------------ | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | | `groupId` | Yes | Workflow or enrichment group to run. | ### sim tables rows batch-update [#sim-tables-rows-batch-update] Update every row matching a filter ```bash sim tables rows batch-update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--filter ` | Yes | Predicate: \{"all":\[\{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull (JSON, or @path / @- to read a file or stdin). | | `--data ` | Yes | Row-data patch applied to every matching row. (JSON, or @path / @- to read a file or stdin). | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `-y, --yes` | No | Skip the confirmation. | ### sim tables rows update [#sim-tables-rows-update] Update Row ```bash sim tables rows update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ---------------------------- | | `tableId` | Yes | Unique table identifier. | | `rowId` | Yes | Unique table row identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | ------------------------------------------------------------------------------------------- | | `--data ` | Yes | Partial row-data patch keyed by column name. (JSON, or @path / @- to read a file or stdin). | ### sim tables views create [#sim-tables-views-create] Create View ```bash sim tables views create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ------------------------ | -------- | --------------------------------------------------------------------------------------------------- | | `--name ` | Yes | Saved-view display name. | | `--config ` | Yes | Saved filter, sort, and column-layout configuration. (JSON, or @path / @- to read a file or stdin). | ### sim tables views delete [#sim-tables-views-delete] Delete View ```bash sim tables views delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ----------------------------- | | `tableId` | Yes | Unique table identifier. | | `viewId` | Yes | Unique saved-view identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim tables views get [#sim-tables-views-get] Get View ```bash sim tables views get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ----------------------------- | | `tableId` | Yes | Unique table identifier. | | `viewId` | Yes | Unique saved-view identifier. | ### sim tables views list [#sim-tables-views-list] List Views ```bash sim tables views list ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables views update [#sim-tables-views-update] Update View ```bash sim tables views update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ----------------------------- | | `tableId` | Yes | Unique table identifier. | | `viewId` | Yes | Unique saved-view identifier. | **Options** | Option | Required | Description | | ------------------------------ | -------- | ------------------------------------------------------------------------------------------------ | | `--name ` | No | Replacement saved-view display name. | | `--config ` | No | Complete replacement saved-view configuration. (JSON, or @path / @- to read a file or stdin). | | `--config-patch ` | No | Saved-view configuration fields to shallow-merge. (JSON, or @path / @- to read a file or stdin). | | `--is-default` | No | Whether to promote this view to the table default. | | `--no-is-default` | No | Send --is-default as false. | ### sim tables delete [#sim-tables-delete] Delete Table ```bash sim tables delete [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim tables get [#sim-tables-get] Get Table ```bash sim tables get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | ### sim tables list [#sim-tables-list] List Tables ```bash sim tables list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--folder ` | No | Folder path; the leading / is optional. | | `--search ` | No | Case-insensitive substring match against the resource name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim tables count create [#sim-tables-count-create] Count Rows ```bash sim tables count create [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--predicate ` | No | Recursive predicate tree. Each group node is exactly one non-empty `all` or `any` array whose members are further groups or `{ field, op, value }` conditions; the root must be a group, not a bare condition. At most 100 members per group, 10 levels of nesting, and 500 nodes in total. The negating operators include nulls: `ne`, `nin`, `ncontains`, `nlike`, and `nilike` match rows whose column is null or absent, so "not X" is not the complement of "X" over a nullable column. That holds for every column type, multi-select included. To exclude nulls, `all`-combine the negation with `isNotEmpty` (multi-select) or `isNotNull`. Comparison: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`. Membership: `in`, `nin` (array operand). Emptiness: `isEmpty`, `isNotEmpty`, `isNull`, `isNotNull` (no operand). Substring, always case-insensitive, operand matched literally: `contains`, `ncontains`, `startsWith`, `endsWith`. Pattern: `like`/`nlike` (case-sensitive), `ilike`/`nilike` (case-insensitive). **`*` is the only wildcard** and stands for any run of characters; `%`, `_`, and backslash match themselves. Use `like: "Hi*"`, not `like: "Hi%"`. A `select` column compares by option id and restricts its operators: single-select accepts `eq`, `ne`, `in`, `nin`; multi-select accepts `contains`, `ncontains`. Option names are accepted as operands and resolved to ids. (JSON, or @path / @- to read a file or stdin). | ### sim tables update [#sim-tables-update] Update Table ```bash sim tables update [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | -------------------------------------------------------------------------- | | `--name ` | No | Identifier: letters, numbers, and underscores; cannot start with a number. | | `--description ` | No | Replacement table description, or null to clear it. | | `--folder ` | No | Folder path; the leading / is optional. | ### sim tables mv [#sim-tables-mv] Move a table to a folder ```bash sim tables mv ``` **Arguments** | Argument | Required | Description | | --------- | -------- | -------------------------------------- | | `tableId` | Yes | Unique table identifier. | | `folder` | Yes | Folder path; the leading / is optional | ### sim tables upsert [#sim-tables-upsert] Insert a row, or update the one that conflicts on a unique column ```bash sim tables upsert [options] ``` **Arguments** | Argument | Required | Description | | --------- | -------- | ------------------------ | | `tableId` | Yes | Unique table identifier. | **Options** | Option | Required | Description | | ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--data ` | Yes | Complete set of row cells keyed by column name. On the update branch this REPLACES the matched row: any column not present here is cleared, unlike the merging `PATCH /api/v2/tables/{tableId}/rows/{rowId}`. (JSON, or @path / @- to read a file or stdin). | | `--on ` | No | Unique column to resolve the conflict against. | ### sim tables import [#sim-tables-import] Import a CSV, into a new table by default ```bash sim tables import [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------------------------------- | | `path` | No | Local CSV file to import; omit when using --file-id | **Options** | Option | Required | Description | | -------------------------------- | -------- | ----------------------------------------------------------------------------------------------------- | | `--name ` | No | Identifier for the new table: letters, numbers, and underscores; defaults to the sanitized file name. | | `--table-id ` | No | Import into this existing table instead of creating one. | | `--mode ` | No | How to write into --table-id (default: append). Accepted values: `append`, `replace`. | | `--folder ` | No | Folder path for the new table. | | `--file-id ` | No | Import a file already in the workspace instead of a local path. | | `--mapping ` | No | Column mapping (--table-id only). | | `--create-columns ` | No | Columns to create (--table-id only). | | `--timezone ` | No | Timezone for date parsing, e.g. America/New\_York. | | `--no-wait` | No | Return once the import is queued instead of watching it. | ### sim tables ls [#sim-tables-ls] List table resources and child folders together ```bash sim tables ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | ----------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `100`. | ### sim tables mkdir [#sim-tables-mkdir] Create a table directory at a path ```bash sim tables mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim workflows [#sim-workflows] Also spelled `sim workflow`. ### sim workflows runs cancel [#sim-workflows-runs-cancel] Cancel a running workflow run ```bash sim workflows runs cancel [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | ------------ | | `--workflow ` | Yes | Workflow ID. | ### sim workflows runs get [#sim-workflows-runs-get] Show run status (requested outputs are included in JSON or YAML output) ```bash sim workflows runs get [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | ---------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--include-output` | No | Include the final output in JSON or YAML output. | | `--select-output ` | No | Include blockName.field values in JSON or YAML output (e.g. agent\_1.content) (space-separated, or @path / @- with one value per line). | ### sim workflows runs list [#sim-workflows-runs-list] List runs for a workflow ```bash sim workflows runs list [options] ``` **Options** | Option | Required | Description | | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--status ` | No | Filter by run status. Accepted values: `pending`, `running`, `completed`, `failed`, `cancelled`, `paused`. | | `--trigger ` | No | Filter by trigger type. | | `--start-date ` | No | Only include runs started at or after this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--end-date ` | No | Only include runs started at or before this UTC ISO 8601 timestamp, e.g. `2026-08-06T00:00:00Z`. A date without a time, or a timestamp carrying a UTC offset instead of `Z`, is rejected, as is year `0000`, which names no storable instant. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--order ` | No | Sort direction by run start time. This list is sortable only by run start time, so it takes `order` in place of `sortBy`/`sortOrder`, which it rejects. Accepted values: `asc`, `desc`. | ### sim workflows runs resume [#sim-workflows-runs-resume] Resume a paused run (output is included in JSON or YAML output) ```bash sim workflows runs resume [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------- | | `runId` | Yes | Unique workflow run identifier. | **Options** | Option | Required | Description | | ------------------------- | -------- | ------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow ID. | | `--context ` | Yes | Pause context ID returned by run status. | | `--input ` | No | Resume input as JSON (JSON, or @path / @- to read a file or stdin). | ### sim workflows create [#sim-workflows-create] Create Workflow ```bash sim workflows create [options] ``` **Options** | Option | Required | Description | | ----------------------- | -------- | --------------------------------------- | | `--name ` | Yes | Workflow name. | | `--description ` | No | Optional workflow description. | | `--folder ` | No | Folder path; the leading / is optional. | ### sim workflows folders create [#sim-workflows-folders-create] Create a workflow folder at a path ```bash sim workflows folders create ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | ### sim workflows folders delete [#sim-workflows-folders-delete] Delete Workflow Folder ```bash sim workflows folders delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------- | | `--recursive` | No | Delete the folder and its descendants. | | `-y, --yes` | No | Skip the confirmation. | ### sim workflows folders list [#sim-workflows-folders-list] List Workflow Folders ```bash sim workflows folders list [options] ``` Also available as `sim workflows folders ls`. **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--parent ` | No | Direct parent folder path. | | `--search ` | No | Case-insensitive substring match against the folder name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `name`, `createdAt`, `updatedAt`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim workflows folders move [#sim-workflows-folders-move] Rename or move a workflow folder ```bash sim workflows folders move ``` Also available as `sim workflows folders mv`. **Arguments** | Argument | Required | Description | | ------------- | -------- | -------------------------------------- | | `path` | Yes | Folder path; the leading / is optional | | `destination` | Yes | Folder path; the leading / is optional | ### sim workflows delete [#sim-workflows-delete] Delete Workflow ```bash sim workflows delete [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------- | -------- | ---------------------- | | `-y, --yes` | No | Skip the confirmation. | ### sim workflows deploy [#sim-workflows-deploy] Deploy Workflow ```bash sim workflows deploy [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------- | | `--name ` | No | Optional label for the deployment version. | | `--description ` | No | Optional release note for the deployment version. | ### sim workflows run [#sim-workflows-run] Run a deployed workflow ```bash sim workflows run [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `--input ` | No | Trigger input as JSON (JSON, or @path / @- to read a file or stdin). | | `--async` | No | Queue the run and return immediately. | | `--execution-timeout-seconds ` | No | Requested server-side timeout for an asynchronous run, in seconds. An upper bound, not the effective timeout: the run uses the smaller of this value and the plan's execution timeout, so requesting more than the plan allows silently yields the plan timeout. Rejected with `400` unless `async` is true. | | `--select-output ` | No | Return blockName.field values (e.g. agent\_1.content); missing fields are omitted (space-separated, or @path / @- with one value per line). | | `--include-file-base64` | No | Inline eligible output files as base64 content. Rejected when `async` is true. | | `--no-include-file-base64` | No | Send --include-file-base64 as false. | | `--base64-max-bytes ` | No | Maximum total bytes of file content to inline as base64. Rejected when `async` is true. | ### sim workflows export [#sim-workflows-export] Print a workflow as a portable JSON document ```bash sim workflows export ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | ### sim workflows get [#sim-workflows-get] Get Workflow ```bash sim workflows get ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | ### sim workflows deployment list [#sim-workflows-deployment-list] Get Workflow Deployment ```bash sim workflows deployment list ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | ### sim workflows versions get [#sim-workflows-versions-get] Get Workflow Version ```bash sim workflows versions get ``` **Arguments** | Argument | Required | Description | | --------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | | `version` | Yes | Numeric deployment version. | ### sim workflows versions list [#sim-workflows-versions-list] List Workflow Versions ```bash sim workflows versions list [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | ### sim workflows import [#sim-workflows-import] Import Workflow ```bash sim workflows import [options] ``` **Options** | Option | Required | Description | | -------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `--workflow ` | Yes | Workflow export object, bare workflow state, or JSON string containing either form. (JSON, or @path / @- to read a file or stdin). | | `--folder ` | No | Folder path; the leading / is optional. | | `--name ` | No | Override for the imported workflow name. | | `--description ` | No | Override for the imported workflow description. | ### sim workflows list [#sim-workflows-list] List Workflows ```bash sim workflows list [options] ``` **Options** | Option | Required | Description | | ---------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--folder ` | No | Folder path; the leading / is optional. | | `--deployed-only` | No | Return only workflows with an active deployment when true. | | `--no-deployed-only` | No | Send --deployed-only as false. | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. | | `--search ` | No | Case-insensitive substring match against the resource name. | | `--sort-by ` | No | Field used to sort the result. Sorting by `name` is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: `position`, `name`, `createdAt`, `updatedAt`, `runCount`. | | `--sort-order ` | No | Sort direction. Accepted values: `asc`, `desc`. | ### sim workflows rollback [#sim-workflows-rollback] Rollback Workflow ```bash sim workflows rollback [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ------------------- | -------- | ----------------------------------------------------------------------------- | | `--version ` | No | Deployment version to reactivate. Omit to select the previous active version. | ### sim workflows undeploy [#sim-workflows-undeploy] Take a workflow out of deployment ```bash sim workflows undeploy ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | ### sim workflows update [#sim-workflows-update] Update Workflow ```bash sim workflows update [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | --------------------------- | | `id` | Yes | Unique workflow identifier. | **Options** | Option | Required | Description | | ----------------------- | -------- | ------------------------------------------------- | | `--name ` | No | Replacement workflow name. | | `--description ` | No | Replacement workflow description; null clears it. | | `--folder ` | No | Folder path; the leading / is optional. | ### sim workflows mv [#sim-workflows-mv] Move a workflow to a folder ```bash sim workflows mv ``` **Arguments** | Argument | Required | Description | | -------- | -------- | -------------------------------------- | | `id` | Yes | Unique workflow identifier. | | `folder` | Yes | Folder path; the leading / is optional | ### sim workflows ls [#sim-workflows-ls] List workflow resources and child folders together ```bash sim workflows ls [path] [options] ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | No | Folder path to list; defaults to the root folder | **Options** | Option | Required | Description | | ----------------- | -------- | ----------------------------------------------------------------------- | | `--search ` | No | Filter folders and resources by name. | | `--limit ` | No | Maximum combined items to return (0 for everything). Defaults to `100`. | ### sim workflows mkdir [#sim-workflows-mkdir] Create a workflow directory at a path ```bash sim workflows mkdir ``` **Arguments** | Argument | Required | Description | | -------- | -------- | ------------------------------------------------ | | `path` | Yes | Folder path to create; the leading / is optional | ## sim workspaces [#sim-workspaces] Also spelled `sim workspace`. ### sim workspaces get [#sim-workspaces-get] Get Workspace ```bash sim workspaces get ``` ### sim workspaces members [#sim-workspaces-members] List workspace members ```bash sim workspaces members [options] ``` **Options** | Option | Required | Description | | ------------- | -------- | -------------------------------------------------------------- | | `--limit ` | No | Maximum items to return (0 for everything). Defaults to `100`. |