rmdir -p

Definition

rmdir -p is a shell command option used with rmdir that removes a directory and then attempts to remove its parent directories, one level at a time, stopping if a parent is not empty or removal fails. On Unix-like systems rmdir only removes empty directories; the -p (or --parents) flag causes rmdir to walk up the path and remove ancestor directories that are empty after the child is removed.

Why it matters

rmdir -p saves time when you want to clean up a chain of empty directories created during development or testing, without having to run separate remove commands for each level. It is safer than recursive removal commands because it refuses to delete directories that still contain files, reducing the risk of accidental data loss.

Example in VCA

Create a nested test directory, remove the deepest directory and then remove empty parents:

mkdir -p ~/vibe-projects/temp/session rmdir -p ~/vibe-projects/temp/session

If session is empty, rmdir removes session, then removes temp if temp becomes empty. If temp contains other files or directories, rmdir will remove session but stop at temp.

Another Real World Example

During a build process you might end up with empty intermediate folders. After confirming nothing important remains, you can tidy them up:

rmdir -p /var/www/my-site/build/tmp/cache

This will delete cache, then cache's parent directories up to build as long as each is empty.

Common mistakes

Expecting rmdir -p to remove non-empty directories. It will not; use rm -r only when you intentionally want recursive deletion.
Assuming the same flags apply on Windows. In PowerShell rmdir is an alias for Remove-Item and does not support -p; Windows cmd uses rd with different options.
Running rmdir -p without checking current directory or path, which can lead to surprising removals if you pass an unintended path.
Confusing mkdir -p (creates parents) with rmdir -p (removes empty parents). They are complementary but opposite actions.
Using rmdir -p with elevated privileges without understanding permissions; it may remove directories you did not intend if they are empty and writable by the command user.

Related terms

rmdir
mkdir
mkdir -p
rm
rm -r
rd
Remove-Item
empty directory
parent directory
recursive delete