drop

Permanently delete a stash and all its files. This operation is irreversible.

Usage

fcheap drop <stash-id> [flags]

Flags

Flag	Type	Default	Description
--force	bool	false	Required to confirm deletion

Examples

# Drop a stash (requires --force)
fcheap drop my_artifacts_20260622_115254 --force

Safety

The --force flag is required to prevent accidental deletion. Without it, fcheap will refuse to drop the stash and print a warning.

Output

Dropped stash: my_artifacts_20260622_115254

The stash bytes and metadata row are removed first, followed by derived search index cleanup. If that final cleanup fails, JSON reports status: "dropped_with_failures" with a failed entry and the command exits nonzero; vacuum can repair the derived index later.