@steipete/oracle 1.0.5 → 1.0.6

package/README.md

@@ -85,4 +85,5 @@ pnpm test:coverage
 ---
 
 If you’re looking for an even more powerful context-management tool, check out https://repoprompt.com
+
 Name inspired by: https://ampcode.com/news/oracle

package/dist/bin/oracle-cli.js

@@ -39,7 +39,10 @@ program.hook('preAction', (thisCommand) => {
         thisCommand.setOptionValue('prompt', positional);
     }
     if (shouldRequirePrompt(rawCliArgs, opts)) {
-        throw new Error('Prompt is required. Provide it via --prompt "<text>".');
+        console.log(chalk.yellow('Prompt is required. Provide it via --prompt "<text>" or positional [prompt].'));
+        thisCommand.help({ error: false });
+        process.exitCode = 1;
+        return;
     }
 });
 program

package/dist/src/cli/help.js

@@ -47,7 +47,7 @@ function renderHelpFooter(program, colors) {
         `${colors.bullet('•')} The model has no built-in knowledge of your project—open with the architecture, key components, and why you’re asking.`,
         `${colors.bullet('•')} Run ${colors.accent('--files-report')} to inspect token spend before hitting the API.`,
         `${colors.bullet('•')} Non-preview runs spawn detached sessions so they keep streaming even if your terminal closes — reattach anytime via ${colors.accent('pnpm oracle session <slug>')}.`,
-        `${colors.bullet('•')} Ask the model for a memorable 3–5 word slug and pass it via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
+        `${colors.bullet('•')} Set a memorable 3–5 word slug via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
         `${colors.bullet('•')} Need hidden flags? Run ${colors.accent(`${program.name()} --help --verbose`)} to list search/token/browser overrides.`,
     ].join('\n');
     const formatExample = (command, description) => `${colors.command(`  ${command}`)}\n${colors.muted(`    ${description}`)}`;

package/dist/src/cli/sessionDisplay.js

@@ -51,7 +51,6 @@ export async function attachSession(sessionId, options) {
     }
     const initialStatus = metadata.status;
     if (!options?.suppressMetadata) {
-        console.log(chalk.bold(`Session: ${sessionId}`));
         const reattachLine = buildReattachLine(metadata);
         if (reattachLine) {
             console.log(chalk.blue(reattachLine));

package/dist/src/oracle/run.js

@@ -92,7 +92,11 @@ export async function runOracle(options, deps = {}) {
     logVerbose(`Estimated tokens (prompt + files): ${estimatedInputTokens.toLocaleString()}`);
     const fileCount = files.length;
     const cliVersion = getCliVersion();
-    const headerLine = `Oracle (${cliVersion}) consulting ${modelConfig.model}'s crystal ball with ${estimatedInputTokens.toLocaleString()} tokens and ${fileCount} files...`;
+    const richTty = process.stdout.isTTY && chalk.level > 0;
+    const headerModelLabel = richTty ? chalk.cyan(modelConfig.model) : modelConfig.model;
+    const tokenLabel = richTty ? chalk.green(estimatedInputTokens.toLocaleString()) : estimatedInputTokens.toLocaleString();
+    const fileLabel = richTty ? chalk.magenta(fileCount.toString()) : fileCount.toString();
+    const headerLine = `Oracle (${cliVersion}) consulting ${headerModelLabel}'s crystal ball with ${tokenLabel} tokens and ${fileLabel} files...`;
     const shouldReportFiles = (options.filesReport || fileTokenInfo.totalTokens > inputTokenBudget) && fileTokenInfo.stats.length > 0;
     if (!isPreview) {
         log(headerLine);
@@ -145,6 +149,7 @@ export async function runOracle(options, deps = {}) {
     let answerHeaderPrinted = false;
     const ensureAnswerHeader = () => {
         if (!options.silent && !answerHeaderPrinted) {
+            log('');
             log(chalk.bold('Answer:'));
             answerHeaderPrinted = true;
         }
@@ -325,7 +330,7 @@ async function executeBackgroundResponse(params) {
             isActive: () => heartbeatActive,
             makeMessage: (elapsedMs) => {
                 const elapsedText = formatElapsed(elapsedMs);
-                return `OpenAI background run still in progress — ${elapsedText} elapsed (id=${responseId}).`;
+                return `OpenAI background run still in progress — ${elapsedText} elapsed.`;
             },
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5 Pro and GPT-5.1 high reasoning modes.",
   "type": "module",
   "main": "dist/bin/oracle-cli.js",