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

# microservice:remove

> Remove an existing microservice.

Delete a microservice module and unregister it from the app module, shared module, app config, env config, docker-compose, tsconfig path aliases, and commitlint config. The `app` and `shared` modules cannot be removed, and you are asked to confirm before deletion.

## Usage

```bash theme={null}
ooneex microservice:remove [options]
```

## Examples

```bash theme={null}
# Interactive: prompts for the name, then confirms
ooneex microservice:remove

# Provide the name as a flag
ooneex microservice:remove --name=billing

# Run against a specific project directory
ooneex microservice:remove --name=billing --cwd=/path/to/project
```

## Options

| Option     | Description                                                                                                                            | Default                   |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `--name`   | Microservice name to remove. Normalized to PascalCase with any trailing `Module` stripped; the module folder uses its kebab-case form. | Prompted if omitted       |
| `--cwd`    | Project directory the microservice is removed from.                                                                                    | Current working directory |
| `--silent` | Suppress the confirmation prompt and output.                                                                                           | `false`                   |