@bramblex/codex-workbench 0.1.1 → 0.1.3

package/README.md

@@ -48,7 +48,9 @@ codex-workbench resume <session> [prompt...]
 codex-workbench fork <session>
 codex-workbench archive <session>
 codex-workbench unarchive <session>
-codex-workbench delete <session> [--force]
+codex-workbench hide <session>
+codex-workbench unhide <session>
+codex-workbench delete <session> [--force] [--file]
 ```
 
 Run without arguments to open the interactive UI:
@@ -72,6 +74,20 @@ codex-workbench list --cwd /path/to/project
 codex-workbench list --all
 ```
 
+Use `hide` for sessions that Codex itself can no longer resume, archive, or delete. Hidden sessions are removed from the default list but remain visible with `--all`:
+
+```sh
+codex-workbench hide <session>
+codex-workbench unhide <session>
+codex-workbench list --all
+```
+
+Use `delete --file` only for broken sessions that Codex can no longer remove. It deletes the local session JSONL file directly:
+
+```sh
+codex-workbench delete <session> --file
+```
+
 Use `doctor` to check which Codex executable the CLI will launch:
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bramblex/codex-workbench",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Terminal workbench for browsing and managing local Codex sessions.",
   "license": "MIT",
   "repository": {

package/src/cli.js

@@ -27,7 +27,9 @@ Usage:
   codex-workbench fork <session>
   codex-workbench archive <session>
   codex-workbench unarchive <session>
-  codex-workbench delete <session> [--force]
+  codex-workbench hide <session>
+  codex-workbench unhide <session>
+  codex-workbench delete <session> [--force] [--file]
 
 Environment:
   CODEX_HOME            default: ~/.codex
@@ -175,7 +177,7 @@ function truncate(text, width) {
 
 function printList(sessions, opts = {}) {
   const filtered = sessions.filter((session) => {
-    if (!opts.all && session.archived) return false;
+    if (!opts.all && (session.archived || session.hidden)) return false;
     if (opts.cwd) return path.resolve(session.cwd) === path.resolve(opts.cwd);
     return true;
   });
@@ -192,7 +194,7 @@ function printList(sessions, opts = {}) {
     console.log(`\n${cwd}`);
     for (const session of group) {
       const label = session.name || truncate(session.first || session.last || '(no prompt)', 56);
-      const flags = [session.archived ? 'archived' : '', session.note ? 'note' : ''].filter(Boolean).join(',');
+      const flags = [session.archived ? 'archived' : '', session.hidden ? 'hidden' : '', session.note ? 'note' : ''].filter(Boolean).join(',');
       console.log(`  ${shortId(session.id)}  ${localTime(session.updatedAt)}  ${String(session.turns).padStart(2)} turns  ${flags ? `[${flags}] ` : ''}${label}`);
     }
   }
@@ -200,7 +202,7 @@ function printList(sessions, opts = {}) {
 }
 
 function printShow(session) {
-  console.log(`${session.name || '(unnamed)'} ${session.archived ? '[archived]' : ''}`);
+  console.log(`${session.name || '(unnamed)'} ${session.archived ? '[archived]' : ''}${session.hidden ? '[hidden]' : ''}`);
   console.log(`id:       ${session.id}`);
   console.log(`cwd:      ${session.cwd}`);
   console.log(`started:  ${localTime(session.startedAt)}`);
@@ -244,6 +246,18 @@ function updateMetadata(session, patch) {
   writeJson(META_PATH, meta);
 }
 
+function removeMetadata(session) {
+  const meta = loadMeta();
+  delete meta.sessions[session.id];
+  meta.updatedAt = new Date().toISOString();
+  writeJson(META_PATH, meta);
+}
+
+function deleteSessionFile(session) {
+  fs.unlinkSync(session.file);
+  removeMetadata(session);
+}
+
 function usableCwd(dir) {
   const candidates = [dir, process.cwd(), HOME];
   for (const candidate of candidates) {
@@ -303,6 +317,7 @@ function parseFlags(args) {
     if (arg === '--json') out.json = true;
     else if (arg === '--all') out.all = true;
     else if (arg === '--force') out.force = true;
+    else if (arg === '--file') out.file = true;
     else if (arg === '--cwd') {
       if (i + 1 >= args.length) throw new Error('--cwd requires a directory.');
       out.cwd = args[++i];
@@ -524,7 +539,7 @@ async function ui() {
   const promptOpen = () => prompt.visible || question.visible;
 
   const reload = () => {
-    sessions = listSessions().filter((s) => !s.archived);
+    sessions = listSessions().filter((s) => !s.archived && !s.hidden);
     groups = ['All', ...new Set(sessions.map((s) => s.cwd))];
     if (groupIndex >= groups.length) groupIndex = Math.max(0, groups.length - 1);
     const visible = currentSessions();
@@ -594,6 +609,7 @@ async function ui() {
     }
     if (status === 0) refreshAfterAction(doneText);
     else refreshAfterAction(`${command} exited with code ${status}.`, true);
+    return status;
   };
 
   const runAction = async (action) => {
@@ -712,7 +728,20 @@ async function ui() {
       setMessage('Delete cancelled.');
       return render();
     }
-    runCodexAndReturn('delete', session, ['--force'], `Deleted ${shortId(session.id)}.`);
+    const status = runCodexAndReturn('delete', session, ['--force'], `Deleted ${shortId(session.id)}.`);
+    if (status !== 0) {
+      const removeFile = await askConfirm(`Codex could not delete ${shortId(session.id)}. Delete its session file?`);
+      if (removeFile) {
+        deleteSessionFile(session);
+        refreshAfterAction(`Deleted file for ${shortId(session.id)}.`);
+        return;
+      }
+      const hideSession = await askConfirm(`Hide ${shortId(session.id)} from workbench instead?`);
+      if (hideSession) {
+        updateMetadata(session, { hidden: true });
+        refreshAfterAction(`Hidden ${shortId(session.id)}.`);
+      }
+    }
   }));
 
   sessionsList.focus();
@@ -739,7 +768,13 @@ async function main() {
   if (cmd === 'fork') return codexCommand('fork', resolveSession(flags._[0], sessions), [], true);
   if (cmd === 'archive') return codexCommand('archive', resolveSession(flags._[0], sessions));
   if (cmd === 'unarchive') return codexCommand('unarchive', resolveSession(flags._[0], sessions));
-  if (cmd === 'delete') return codexCommand('delete', resolveSession(flags._[0], sessions), flags.force ? ['--force'] : []);
+  if (cmd === 'hide') return updateMetadata(resolveSession(flags._[0], sessions), { hidden: true });
+  if (cmd === 'unhide') return updateMetadata(resolveSession(flags._[0], sessions), { hidden: false });
+  if (cmd === 'delete') {
+    const session = resolveSession(flags._[0], sessions);
+    if (flags.file) return deleteSessionFile(session);
+    return codexCommand('delete', session, flags.force ? ['--force'] : []);
+  }
 
   usage();
   process.exitCode = 2;