Skip to main content
Remove one or more packages from your project’s dependencies.

Usage

ant remove <package>... [options]
ant rm <package>... [options]

Parameters

package
string
required
Name of the package to remove. Can specify multiple packages.

Options

-g, --global
boolean
Remove from global packages instead of local.
--verbose
boolean
Enable verbose output.
-h, --help
boolean
Display help information.

Examples

Remove a package

ant remove lodash
Output:
ant remove v1.0.0 (abc123)

45 packages installed [234ms]
- Removed: lodash

Remove multiple packages

ant remove express body-parser cors

Remove from global

ant remove -g typescript
Output:
ant remove -g v1.0.0 (abc123)

- Removed globally: typescript

Package not found

ant remove nonexistent-package
Output:
ant remove v1.0.0 (abc123)

[0ms] done

Behavior

  • Removes package from package.json dependencies or devDependencies
  • Updates ant.lockb lockfile
  • Removes unused dependencies from node_modules
  • Re-installs remaining dependencies

Removing Dependencies vs DevDependencies

Ant automatically detects whether the package is in dependencies or devDependencies and removes it from the correct section.

Transitive Dependencies

Removing a package also removes its dependencies if they’re not required by other packages:
ant remove express
# Also removes: body-parser, cookie, etc. (if unused)

Global Removal

Global packages are removed from ~/.ant/pkg/global/node_modules and their binaries are unlinked from ~/.ant/bin.

Build docs developers (and LLMs) love