> ## Documentation Index
> Fetch the complete documentation index at: https://graph.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# builtin__save_tool

> Saves a drafted tool to the project's tools directory and loads it immediately as `user__<name>`.

* The tool must pass `builtin__try_tool` first, unless `untested` is true.
* Won't replace an existing file unless `overwrite` is true.

| Available to | Effect |
| - | - |
| Any agent or plan step | Has side effects |

## Input

**overwrite** `boolean`

Replace an existing file with the same name, only after the user confirms

**untested** `boolean`

Save without a test run, only when the user said not to test it

**yaml** `string` *required*

The whole user tool file, exactly as tested

## Output

**error** `string`

**path** `string`

**problems** `string[]`

**saved** `string`

**untested** `boolean`

```yaml Plan step theme={null}
- id: E1
  tool_name: builtin__save_tool
  input:
    yaml: "{{input.yaml}}"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.