Tool Commands | BCTRL Docs

Define tools, bundle toolsets, and inspect tool calls.

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

`bctrl tools list`

List tools

$ bctrl tools list [flags]

Flag	Description
`--space <id>`	Filter by space id
`-L, --limit <number>`	Maximum number of results to return
`--cursor <cursor>`	Pagination cursor

Get a tool

$ bctrl tools get <id>

Create a tool

$ bctrl tools create

Update a tool

$ bctrl tools patch <id>

Call a tool and wait for its result

$ bctrl tools call <toolRef> [flags]

Flag	Description
`--runtime <id>`	Runtime whose active Run should execute the Tool

Start an asynchronous tool call

$ bctrl tools start <toolRef> [flags]

Flag	Description
`--runtime <id>`	Runtime whose active Run should execute the Tool

Delete a tool

$ bctrl tools delete <id> [flags]

Flag	Description
`-y, --yes`	Confirm deletion

List toolsets

$ bctrl toolsets list [flags]

Flag	Description
`--space <id>`	Filter by space id

View a toolset

$ bctrl toolsets get <id>

Create a toolset

$ bctrl toolsets create

Edit a toolset

$ bctrl toolsets patch <id>

Delete a toolset

$ bctrl toolsets delete <id> [flags]

Flag	Description
`-y, --yes`	Confirm deletion

List tool calls

$ bctrl tool-calls list [flags]

Cancel a tool call

$ bctrl tool-calls cancel <toolCallId>

Respond to a tool input request

$ bctrl tool-calls respond <toolCallId>

Wait for and return a tool call result

$ bctrl tool-calls result <toolCallId>

View a tool call

$ bctrl tool-calls get <id>