> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing tools

Manage the tools in your active environment.

## Listing tools

Use the `orchestrate tools list` command to list all tools in your environment. You can also use the `--verbose` (`-v`) flag to get detailed information about each tool in JSON format.

```bash BASH theme={null}
orchestrate tools list -v
```

## Exporting tools

Use the `orchestrate tools export` command to export a tool configuration from your active environment. The command exports Python, Agentic Workflow and Langflow tools, and only OpenAPI tools that were imported using CLI.

```bash BASH theme={null}
orchestrate tools export -n <tool-name> -o <zip-output-path>
```

<Expandable title="command flags">
  | Flag              | Type   | Required | Description                                                |
  | ----------------- | ------ | -------- | ---------------------------------------------------------- |
  | `--name` (`-n`)   | string | Yes      | The name of the tool you want to export.                   |
  | `--output` (`-o`) | string | Yes      | Name of the zip file you would like to export the tool to. |
</Expandable>

<Note>
  **Note:**

  * Starting with version 1.12.0, agentic workflow tools export only when you use a local environment with **watsonx Orchestrate Developer Edition**.
  * Starting with version 1.15.0, you can export agentic workflow tools in SaaS environments using this command. This feature is now available in **Public Preview**.
  * Starting with version 1.15.0, exporting an agentic workflow tool also exports all tools associated with that workflow.
</Note>

## Updating tools

To update a tool, run the import command again using the same tool name that you want to update.

```bash BASH theme={null}
orchestrate tools import -k <kind of the tool> -f <path the tool file that you want to update> -a <id of the app> -r <path to the requirements.txt file>
```

## Removing tools

Use the `orchestrate tools remove` command to remove an existing tool. This command requires the `--name` (`-n`) flag, which specifies the name of the tool you want to delete.

```bash BASH theme={null}
orchestrate tools remove -n my-tool-name
```