@steipete/oracle 0.4.0 → 0.4.2

package/README.md

@@ -19,52 +19,53 @@ Install globally: `npm install -g @steipete/oracle`
 
 ```bash
 # Copy the bundle and paste into ChatGPT
-npx -y @steipete/oracle --render --copy -p "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"
+npx @steipete/oracle --render --copy -p "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"
 
 # Minimal API run (expects OPENAI_API_KEY in your env)
-npx -y @steipete/oracle -p "Write a concise architecture note for the storage adapters" --file src/storage/README.md
+npx @steipete/oracle -p "Write a concise architecture note for the storage adapters" --file src/storage/README.md
 
 # Multi-model API run
-npx -y @steipete/oracle -p "Cross-check the data layer assumptions" --models gpt-5.1-pro,gemini-3-pro --file "src/**/*.ts"
+npx @steipete/oracle -p "Cross-check the data layer assumptions" --models gpt-5.1-pro,gemini-3-pro --file "src/**/*.ts"
+
+# Preview without spending tokens
+npx @steipete/oracle --dry-run summary -p "Check release notes" --file docs/release-notes.md
 
 # Experimental browser run (no API key, will open ChatGPT)
-npx -y @steipete/oracle --engine browser -p "Walk through the UI smoke test" --file "src/**/*.ts"
+npx @steipete/oracle --engine browser -p "Walk through the UI smoke test" --file "src/**/*.ts"
 
 # Sessions (list and replay)
-npx -y @steipete/oracle status --hours 72
-npx -y @steipete/oracle session <id> --render
+npx @steipete/oracle status --hours 72
+npx @steipete/oracle session <id> --render
 
 # TUI (interactive, only for humans)
-npx -y @steipete/oracle
+npx @steipete/oracle
 ```
 
+Engine auto-picks API when `OPENAI_API_KEY` is set, otherwise browser; browser is stable on macOS, works on Linux with `--browser-chrome-path/--browser-cookie-path`, and is partial/experimental on Windows.
+
 ## Integration
 
 **CLI**
 - API mode expects API keys in your environment: `OPENAI_API_KEY` (GPT-5.x), `GEMINI_API_KEY` (Gemini 3 Pro), `ANTHROPIC_API_KEY` (Claude Sonnet 4.5 / Opus 4.1).
 - Prefer API mode or `--copy` + manual paste; browser automation is experimental.
+- Browser support: stable on macOS; works on Linux with `--browser-chrome-path/--browser-cookie-path`; Windows is partial/experimental.
 - Remote browser service: `oracle serve` on a signed-in host; clients use `--remote-host/--remote-token`.
 - AGENTS.md/CLAUDE.md:
   ```
   - Oracle bundles a prompt plus the right files so another AI (GPT 5 Pro + more) can answer. Use when stuck/bugs/reviewing.
   - Run `npx -y @steipete/oracle --help` once per session before first use.
   ```
+- Tip: set `chatgptUrl` in config (or `--chatgpt-url`) to a dedicated ChatGPT project folder so work runs don’t clutter your main history.
 
 **MCP**
 - Run the stdio server via `oracle-mcp`.
-- Configure clients via [steipete/mcporter](https://github.com/steipete/mcporter) or `.mcp.json`; see [docs/mcp.md](docs/mcp.md) for connection examples and scope options.
+- Configure clients via [steipete/mcporter](https://github.com/steipete/mcporter) or `.mcp.json`; see [docs/mcp.md](docs/mcp.md) for connection examples.
 ```bash
 npx -y @steipete/oracle oracle-mcp
 ```
 - Cursor setup (MCP): drop a `.cursor/mcp.json` like below, then pick “oracle” in Cursor’s MCP sources. See https://cursor.com/docs/context/mcp for UI steps.
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=oracle&config=eyJjb21tYW5kIjoibnB4IC15IEBzdGVpcGV0ZS9vcmFjbGUgb3JhY2xlLW1jcCJ9)
 
-## Related
-- CodexBar: keep Codex and Claude usage visible from the menu bar. Download at <https://codexbar.app>.
-- Trimmy: clipboard flattener for multi-line shell snippets. Download at <https://trimmy.app>.
-- MCPorter: TypeScript runtime/CLI/codegen for MCP. <https://mcporter.dev>.
-- AskOracle: browser UI for Oracle sessions. <https://askoracle.dev>.
-
 ```json
 {
   "oracle": {
@@ -80,8 +81,10 @@ npx -y @steipete/oracle oracle-mcp
 - Multi-model API runs with aggregated cost/usage.
 - Render/copy bundles for manual paste into ChatGPT when automation is blocked.
 - GPT‑5 Pro API runs detach by default; reattach via `oracle session <id>` / `oracle status` or block with `--wait`.
+- Azure endpoints supported via `--azure-endpoint/--azure-deployment/--azure-api-version` or `AZURE_OPENAI_*` envs.
 - File safety: globs/excludes, size guards, `--files-report`.
 - Sessions you can replay (`oracle status`, `oracle session <id> --render`).
+- Session logs and bundles live in `~/.oracle/sessions` (override with `ORACLE_HOME_DIR`).
 
 ## Flags you’ll actually use
 
@@ -94,6 +97,8 @@ npx -y @steipete/oracle oracle-mcp
 | `--models <list>` | Comma-separated API models for multi-model runs. |
 | `--base-url <url>` | Point API runs at LiteLLM/Azure/etc. |
 | `--chatgpt-url <url>` | Target a ChatGPT workspace/folder (browser). |
+| `--browser-inline-cookies[(-file)] <payload|path>` | Supply cookies without Chrome/Keychain (browser). |
+| `--browser-timeout`, `--browser-input-timeout` | Control overall/browser input timeouts (supports h/m/s/ms). |
 | `--render`, `--copy` | Print and/or copy the assembled markdown bundle. |
 | `--wait` | Block for background API runs (e.g., GPT‑5.1 Pro) instead of detaching. |
 | `--write-output <path>` | Save only the final answer (multi-model adds `.<model>`). |
@@ -101,6 +106,7 @@ npx -y @steipete/oracle oracle-mcp
 | `--dry-run [summary\|json\|full]` | Preview without sending. |
 | `--remote-host`, `--remote-token` | Use a remote `oracle serve` host (browser). |
 | `--remote-chrome <host:port>` | Attach to an existing remote Chrome session (browser). |
+| `--azure-endpoint`, `--azure-deployment`, `--azure-api-version` | Target Azure OpenAI endpoints (picks Azure client automatically). |
 
 ## Configuration
 
@@ -109,11 +115,37 @@ Put defaults in `~/.oracle/config.json` (JSON5). Example:
 {
   model: "gpt-5.1-pro",
   engine: "api",
-  filesReport: true
+  filesReport: true,
+  chatgptUrl: "https://chatgpt.com/g/your-project-folder"
 }
 ```
 See [docs/configuration.md](docs/configuration.md) for precedence and full schema.
 
+Advanced flags
+
+| Area | Flags |
+| --- | --- |
+| Browser | `--browser-timeout`, `--browser-input-timeout`, `--browser-inline-cookies[(-file)]`, `--browser-inline-files`, `--browser-bundle-files`, `--browser-keep-browser`, `--browser-headless`, `--browser-hide-window`, `--browser-no-cookie-sync`, `--browser-allow-cookie-errors`, `--browser-chrome-path`, `--browser-cookie-path`, `--chatgpt-url` |
+| Azure/OpenAI | `--azure-endpoint`, `--azure-deployment`, `--azure-api-version`, `--base-url` |
+
+Remote browser example
+```bash
+# Host (signed-in Chrome): launch serve
+oracle serve --host 0.0.0.0:9473 --token secret123
+
+# Client: target that host
+oracle --engine browser --remote-host 192.168.1.10:9473 --remote-token secret123 -p "Run the UI smoke" --file "src/**/*.ts"
+
+# If cookies can’t sync, pass them inline (JSON/base64)
+oracle --engine browser --browser-inline-cookies-file ~/.oracle/cookies.json -p "Run the UI smoke" --file "src/**/*.ts"
+```
+
+Session management
+```bash
+# Prune stored sessions (default path ~/.oracle/sessions; override ORACLE_HOME_DIR)
+oracle status --clear --hours 168
+```
+
 ## More docs
 - Browser mode & forks: [docs/browser-mode.md](docs/browser-mode.md) (includes `oracle serve` remote service), [docs/chromium-forks.md](docs/chromium-forks.md), [docs/linux.md](docs/linux.md)
 - MCP: [docs/mcp.md](docs/mcp.md)
@@ -123,7 +155,7 @@ See [docs/configuration.md](docs/configuration.md) for precedence and full schem
 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
 
-## More awesome stuff from steipete
+## More free stuff from steipete
 - ✂️ [Trimmy](https://trimmy.app) — “Paste once, run once.” Flatten multi-line shell snippets so they paste and run.
 - 🟦🟩 [CodexBar](https://codexbar.app) — Keep Codex token windows visible in your macOS menu bar.
 - 🧳 [MCPorter](https://mcporter.dev) — TypeScript toolkit + CLI for Model Context Protocol servers.

package/dist/bin/oracle-cli.js

@@ -4,6 +4,12 @@ import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { once } from 'node:events';
 import { Command, Option } from 'commander';
+// Allow `npx @steipete/oracle oracle-mcp` to resolve the MCP server even though npx runs the default binary.
+if (process.argv[2] === 'oracle-mcp') {
+    const { startMcpServer } = await import('../src/mcp/server.js');
+    await startMcpServer();
+    process.exit(0);
+}
 import { resolveEngine, defaultWaitPreference } from '../src/cli/engine.js';
 import { shouldRequirePrompt } from '../src/cli/promptRequirement.js';
 import chalk from 'chalk';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.1 Pro, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "type": "module",
   "main": "dist/bin/oracle-cli.js",
@@ -46,6 +46,7 @@
   },
   "homepage": "https://github.com/steipete/oracle#readme",
   "dependencies": {
+    "@anthropic-ai/tokenizer": "^0.0.4",
     "@google/genai": "^1.30.0",
     "@google/generative-ai": "^0.24.1",
     "@modelcontextprotocol/sdk": "^1.22.0",