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

# ai:tool:create

> Generate a new AI tool class.

Scaffold a new AI tool class and its matching test file under a module's `ai/tools` directory. The `@ooneex/ai` dependency is installed if it is not already present.

## Usage

```bash theme={null}
ooneex ai:tool:create [options]
```

## Examples

```bash theme={null}
# Interactive: prompts for the tool name
ooneex ai:tool:create

# Provide the name as a flag
ooneex ai:tool:create --name=WebSearch

# Target a specific module
ooneex ai:tool:create --name=WebSearch --module=help
```

## Options

| Option       | Description                                                                                                                   | Default             |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| `--name`     | Tool name. Normalized to PascalCase with a `Tool` suffix; its `getName()` returns the snake\_case identifier the model calls. | Prompted if omitted |
| `--module`   | Target module the tool is created in.                                                                                         | `shared`            |
| `--override` | Overwrite the files if they already exist.                                                                                    | `false`             |

## AI Skill

This command ships a matching `ai:tool:create` skill. It generates the tool class and test file, then guides your AI agent through implementing a function-calling tool that implements `ITool` from `@ooneex/ai` for use by a chat.

<Tabs>
  <Tab title="Claude">
    ```bash theme={null}
    ooneex claude:init
    ```
  </Tab>

  <Tab title="Codex">
    ```bash theme={null}
    ooneex codex:init
    ```
  </Tab>
</Tabs>