session-steward 0.10.2 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.11.0] - 2026-09-14
+
+### Added
+
+- Sessions and workspaces can be marked Keep so manual and scheduled Session Steward cleanup skip them without indexing transcripts or changing provider data.
+
+## [0.10.3] - 2026-09-10
+
+### Fixed
+
+- Deleted Codex sessions no longer linger in the ChatGPT sidebar.
+- Claude cleanup now handles stale session markers, protects shared history, and removes leftover session files.
+
 ## [0.10.2] - 2026-09-07
 
 ### Fixed
@@ -155,6 +168,8 @@
 - Support for custom Codex home folders and a saved folder preference.
 - Streaming and bounded-memory discovery for large session collections and transcripts.
 
+[0.11.0]: https://github.com/mallikcheripally/session-steward/compare/v0.10.3...v0.11.0
+[0.10.3]: https://github.com/mallikcheripally/session-steward/compare/v0.10.2...v0.10.3
 [0.10.2]: https://github.com/mallikcheripally/session-steward/compare/v0.10.1...v0.10.2
 [0.10.1]: https://github.com/mallikcheripally/session-steward/compare/v0.10.0...v0.10.1
 [0.10.0]: https://github.com/mallikcheripally/session-steward/compare/v0.9.0...v0.10.0

package/README.md

@@ -19,6 +19,7 @@ Session Steward makes session cleanup safer by finding those records, showing wh
 - See session counts and the storage used by recognized session files.
 - Find sessions inactive for 30, 60, or 90 days.
 - Filter active or archived sessions by workspace, name, or session ID.
+- Mark important sessions or workspaces Keep so cleanup skips them.
 - Inspect session details and affected records before deletion.
 - Read a session timeline of what you asked, what changed, and which commands ran.
 - See how many tokens a session used, split into fresh input, cached input, cache writes, and output.
@@ -35,7 +36,11 @@ Session Steward makes session cleanup safer by finding those records, showing wh
 - Thorough cleanup is unavailable when the detected storage format is not supported.
 - Cleanup stays local and does not upload session contents.
 
-At startup, Session Steward may contact the public npm registry to check for a newer version.
+### Keep important sessions
+
+Mark a session or workspace Keep and Session Steward skips it during manual and scheduled cleanup. A workspace Keep also covers descendant folders and future sessions there.
+
+It protects against Session Steward cleanup only. Codex or Claude Code can still remove the data.
 
 ### Session Steward does not remove
 
@@ -46,6 +51,8 @@ At startup, Session Steward may contact the public npm registry to check for a n
 - Conversations stored in your ChatGPT or Claude account
 - Claude Code worktrees, branches, repositories, remote sessions, SSH sessions, or Cowork data
 
+At startup, Session Steward may contact the public npm registry to check for a newer version.
+
 ## Install and get started
 
 Session Steward supports macOS, Linux, and Windows and requires Node.js 24.15 or newer.
@@ -192,6 +199,10 @@ workspace /path/to/project
 internals
 supporting
 tokens
+keep 3
+unkeep 3
+keep-workspace /path/to/project
+unkeep-workspace /path/to/project
 cleanup standard
 cleanup thorough
 overview
@@ -200,6 +211,9 @@ backups
 
 Run `inactive`, `archive`, or `workspace` without a value to clear that filter.
 
+`keep` and `unkeep` accept session selectors. `keep-workspace` and
+`unkeep-workspace` accept a full path.
+
 `backups` lists recovery backups retained after an interrupted or unsuccessful cleanup. Use `restore <number>` to restore one, or `delete-backup <number>` to remove it permanently. Both actions require an explicit confirmation.
 
 </details>
@@ -229,6 +243,8 @@ You can then ask things like:
 - “Find sessions I have not used in 60 days.”
 - “Show sessions from this workspace, largest first.”
 - “Delete those sessions.”
+- “Keep this session from Session Steward cleanup.”
+- “Keep every session in this workspace.”
 - “Every 12 days, delete sessions I have not used in 45 days.”
 - “Restore my latest backup.”
 

package/bin/session-steward-cli.mjs

@@ -106,6 +106,7 @@ async function main() {
     archiveStatus: values["archive-status"],
     backups: values.backups ?? false,
     cleanup: values.cleanup,
+    configDirectory: settings.getConfigDirectory(),
     events: values.events ?? false,
     eventsLimit,
     help,

package/bin/session-steward-scheduler.mjs

@@ -37,13 +37,17 @@ Options:
     "../lib/cleanup-schedules.mjs"
   );
   const { createProviderSettings } = await import("../lib/settings.mjs");
+  const { createSessionProtectionStore } = await import("../lib/session-protections.mjs");
   const settings = await createProviderSettings({
     configDirectory: values["config-directory"],
   });
   const scheduleStore = createCleanupScheduleStore({
     configDirectory: settings.getConfigDirectory(),
   });
-  const results = await runDueCleanupSchedules({ scheduleStore, settings });
+  const protectionStore = createSessionProtectionStore({
+    configDirectory: settings.getConfigDirectory(),
+  });
+  const results = await runDueCleanupSchedules({ protectionStore, scheduleStore, settings });
   if (results.some((result) => ["failed", "recovery-failed"].includes(result.status))) {
     process.exitCode = 1;
   }