> ## 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.

# command:run

> Run a custom command from a module.

Runs a custom command defined in one of the project's modules by its registered name. It scans every module that has a `bin/command/run.ts` entry point, locates the one declaring the requested command, and executes it with any extra arguments forwarded.

## Usage

```bash theme={null}
ooneex command:run [options]
```

## Examples

```bash theme={null}
ooneex command:run import:user
```

```bash theme={null}
ooneex command:run import:user --source=./users.csv
```

## Options

| Option   | Description                                                                                 | Default |
| -------- | ------------------------------------------------------------------------------------------- | ------- |
| `--id`   | Name of the command to run. Falls back to the first positional argument.                    | —       |
| `--args` | Extra arguments forwarded to the command. Falls back to the remaining positional arguments. | —       |