docs: Removing sessions (#2438)

2025-05-05 19:57:10 -04:00
parent 705a858cf2
commit 89fc2ae949
2 changed files with 32 additions and 0 deletions
@@ -139,6 +139,34 @@ goose session list --verbose
 # List sessions in JSON format
 goose session list --format json
 ```
+
+---
+
+### session remove [options]
+
+Remove one or more saved sessions.
+
+**Options:**
+- **`-i, --id <id>`**: Remove a specific session by its ID
+- **`-r, --regex <pattern>`**: Remove sessions matching a regex pattern. For example:
+
+**Usage:**
+
+```bash
+# Remove a specific session by ID
+goose session remove -i 20250305_113223
+
+# Remove all sessions starting with "project-"
+goose session remove -r "project-.*"
+
+# Remove all sessions containing "migration"
+goose session remove -r ".*migration.*"
+```
+
+:::caution
+Session removal is permanent and cannot be undone. Goose will show which sessions will be removed and ask for confirmation before deleting.
+::: 
+
 ---

 ### info [options]