Skip to content

Commands

Custom tools

Create and manage code-backed tools that agents can call.

sim custom-tools is also spelled sim custom-tool.

These commands accept the global options.

List custom tools

Code
sim custom-tools list [options]

Options

OptionRequiredDescription
--search <value>NoCase-insensitive substring match against the tool title.
--sort-by <value>NoField used to sort the result. Defaults to "createdAt". Accepted values: title, createdAt, updatedAt.
--sort-order <value>NoSort direction. Defaults to "desc". Accepted values: asc, desc.
--limit <n>NoMaximum items to return (0 for everything). Defaults to 0.

API request and response schemas: listCustomTools.

Get custom tool

Code
sim custom-tools get <customToolId>

Arguments

ArgumentRequiredDescription
customToolIdYesUnique custom tool identifier.

API request and response schemas: getCustomTool.

Create custom tool

Code
sim custom-tools create [options]

Options

OptionRequiredDescription
--title <value>YesDisplay title, unique within the workspace.
--schema <json|@file>YesOpenAI function schema: {"type":"function","function":{"name":"...","parameters":{"type":"object","properties":{}}}} (JSON, or @path / @- to read a file or stdin).
--code <value>YesTool implementation executed in the sandboxed function runtime.

API request and response schemas: createCustomTool.

Update custom tool

Code
sim custom-tools update <customToolId> [options]

Arguments

ArgumentRequiredDescription
customToolIdYesUnique custom tool identifier.

Options

OptionRequiredDescription
--title <value>NoNew display title for the tool.
--schema <json|@file>NoOpenAI function schema: {"type":"function","function":{"name":"...","parameters":{"type":"object","properties":{}}}} (JSON, or @path / @- to read a file or stdin).
--code <value>NoReplacement tool implementation.

API request and response schemas: updateCustomTool.

Delete custom tool

This deletes the custom tool.

Code
sim custom-tools delete <customToolId> [options]

Arguments

ArgumentRequiredDescription
customToolIdYesUnique custom tool identifier.

Options

OptionRequiredDescription
-y, --yesYesConfirm this operation.

API request and response schemas: deleteCustomTool.

Was this helpful?
Suggest an edit