Skip to main content
Removing a microservice is the exact inverse of creating one. The generator deletes the module’s directory under modules/<name>/ and then unwinds every registration that brought it into the app: the app module, the shared module, the app config, the env config, docker-compose, and the tsconfig path aliases. When it finishes, no trace of the microservice is left in the project. This is a one-command operation. You name the microservice, confirm, and the generator does the rest.

​
What it does

The command works against an existing microservice. It will not create anything, and it refuses to touch the two built-in modules:
  • The app and shared modules cannot be removed — they are part of every project.
  • A name that does not match an existing microservice is reported as an error.
  • You are asked to confirm before anything is deleted, unless you pass --silent.
Once confirmed, the generator unregisters the microservice everywhere (see the list below) and finally deletes the modules/<kebab-name>/ directory.

​
CLI command

Run the generator from your project. With no flags it prompts for the name and then asks you to confirm.
This is destructive. The command deletes the entire modules/<name>/ directory (all controllers, services, entities, tests, and anything else inside it) and removes every reference to the microservice across the project. There is no undo. Commit or branch first so the change is reviewable and reversible through git. The app and shared modules are protected and cannot be removed, and you will be asked to confirm before deletion unless you pass --silent.

​
What gets unregistered

Every wiring step that create performs is reversed:
  • App module (AppModule): the microservice’s module registration is removed.
  • Shared module (SharedModule): the microservice is unregistered.
  • App config (modules/app/app.yml): the entry is removed from the microservices: list.
  • Env config (.env.yml): the microservices: entry is removed.
  • Docker Compose (docker-compose.yml): the app’s service block for the microservice is deleted.
  • TypeScript config (root tsconfig.json): the microservice’s path aliases are removed.
After all of the above, the modules/<kebab-name>/ directory itself is deleted.

​
Use with Claude and Codex

The generator ships a matching microservice:remove skill. It runs the command and walks your AI agent through confirming the removal and verifying that the wiring is gone. Initialize the skills once for your agent:
Then ask Claude in natural language, and it maps the request to the generator and runs it:
Prompt
For example, the prompt above maps to microservice:remove --name=billing, then confirms the deletion when asked.