@bramblex/codex-workbench 0.1.4 → 0.1.5

package/README.md

@@ -40,7 +40,7 @@ codex-workbench list
 ```sh
 codex-workbench [ui]
 codex-workbench doctor
-codex-workbench list [--json] [--cwd <dir>] [--all]
+codex-workbench list [--json] [--compact] [--cwd <dir>] [--all]
 codex-workbench show <session>
 codex-workbench rename <session> <name>
 codex-workbench note <session> <note>
@@ -73,10 +73,13 @@ Use `list` to find sessions:
 ```sh
 codex-workbench list
 codex-workbench list --json
+codex-workbench list --json --compact
 codex-workbench list --cwd /path/to/project
 codex-workbench list --all
 ```
 
+Use `--compact` with `--json` when another tool only needs session summaries. It omits the full message history and keeps remote SSH listings small.
+
 Use `new` to start a fresh Codex session in a project directory:
 
 ```sh

package/package.json

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

package/src/cli-output.js

@@ -10,7 +10,7 @@ function usage() {
 Usage:
   codex-workbench [ui]
   codex-workbench doctor
-  codex-workbench list [--json] [--cwd <dir>] [--all]
+  codex-workbench list [--json] [--compact] [--cwd <dir>] [--all]
   codex-workbench show <session>
   codex-workbench rename <session> <name>
   codex-workbench note <session> <note>
@@ -41,7 +41,8 @@ function printList(sessions, opts = {}) {
     return true;
   });
   if (opts.json) {
-    console.log(JSON.stringify(filtered, null, 2));
+    const payload = opts.compact ? filtered.map(compactSession) : filtered;
+    console.log(JSON.stringify(payload, null, 2));
     return;
   }
   const groups = new Map();
@@ -62,6 +63,11 @@ function printList(sessions, opts = {}) {
   if (!filtered.length) console.log('No sessions found.');
 }
 
+function compactSession(session) {
+  const { messages, ...compact } = session;
+  return compact;
+}
+
 function printShow(session) {
   console.log(`${session.name || '(unnamed)'} ${session.archived ? '[archived]' : ''}${session.hidden ? '[hidden]' : ''}`);
   console.log(`id:       ${session.id}`);
@@ -73,7 +79,7 @@ function printShow(session) {
   console.log(`turns:    ${session.turns}`);
   if (session.note) console.log(`note:     ${session.note}`);
   console.log('\nMessages:');
-  for (const msg of session.messages) {
+  for (const msg of session.messages || []) {
     if (msg.role === 'developer') continue;
     const prefix = msg.role === 'assistant' ? 'A' : msg.role === 'user' ? 'U' : msg.role.slice(0, 1).toUpperCase();
     console.log(`  ${prefix}: ${truncate(msg.text, 180)}`);
@@ -102,6 +108,7 @@ function printDoctor() {
 }
 
 module.exports = {
+  compactSession,
   printDoctor,
   printList,
   printShow,

package/src/cli.js

@@ -27,6 +27,7 @@ function parseFlags(args) {
     const arg = args[i];
     if (arg === '--json') out.json = true;
     else if (arg === '--all') out.all = true;
+    else if (arg === '--compact') out.compact = true;
     else if (arg === '--force') out.force = true;
     else if (arg === '--file') out.file = true;
     else if (arg === '--cwd') {

package/src/services/session-sources.js

@@ -48,7 +48,7 @@ function loadWorkbenchSessions() {
 
   for (const source of sources.filter((candidate) => candidate.remote)) {
     try {
-      const remoteSessions = runRemoteCwbJson(source, ['list', '--json']);
+      const remoteSessions = runRemoteCwbJson(source, ['list', '--json', '--compact']);
       if (!Array.isArray(remoteSessions)) throw new Error('remote list did not return an array');
       sessions.push(...remoteSessions.map((session) => attachSource(session, source)));
     } catch (err) {

package/src/services/ssh-runner.js

@@ -21,13 +21,19 @@ function runRemoteCwb(server, argv, opts = {}) {
   return spawnSync('ssh', args, {
     encoding: opts.encoding,
     env: process.env,
+    maxBuffer: opts.maxBuffer || 64 * 1024 * 1024,
     stdio: opts.stdio || (opts.encoding ? ['ignore', 'pipe', 'pipe'] : 'inherit'),
   });
 }
 
 function runRemoteCwbJson(server, argv) {
   const result = runRemoteCwb(server, argv, { encoding: 'utf8' });
-  if (result.error) throw result.error;
+  if (result.error) {
+    if (result.error.code === 'ENOBUFS') {
+      throw new Error('remote output exceeded buffer; update the remote codex-workbench so compact listing is available');
+    }
+    throw result.error;
+  }
   if (result.status !== 0) {
     const stderr = (result.stderr || '').trim();
     throw new Error(stderr || `ssh exited with code ${result.status}`);