@steipete/oracle 0.9.0 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +61 -48
- package/dist/bin/oracle-cli.js +455 -402
- package/dist/bin/oracle-mcp.js +2 -2
- package/dist/bin/oracle.js +165 -279
- package/dist/scripts/agent-send.js +31 -31
- package/dist/scripts/check.js +6 -6
- package/dist/scripts/debug/extract-chatgpt-response.js +10 -10
- package/dist/scripts/docs-list.js +30 -30
- package/dist/scripts/git-policy.js +25 -23
- package/dist/scripts/run-cli.js +8 -8
- package/dist/scripts/runner.js +203 -195
- package/dist/scripts/test-browser.js +21 -18
- package/dist/scripts/test-remote-chrome.js +20 -20
- package/dist/src/bridge/connection.js +18 -18
- package/dist/src/bridge/userConfigFile.js +7 -7
- package/dist/src/browser/actions/assistantResponse.js +149 -101
- package/dist/src/browser/actions/attachmentDataTransfer.js +49 -47
- package/dist/src/browser/actions/attachments.js +246 -150
- package/dist/src/browser/actions/domEvents.js +2 -2
- package/dist/src/browser/actions/modelSelection.js +275 -117
- package/dist/src/browser/actions/navigation.js +161 -137
- package/dist/src/browser/actions/promptComposer.js +100 -64
- package/dist/src/browser/actions/remoteFileTransfer.js +10 -10
- package/dist/src/browser/actions/thinkingTime.js +207 -110
- package/dist/src/browser/chromeLifecycle.js +62 -60
- package/dist/src/browser/config.js +34 -15
- package/dist/src/browser/constants.js +17 -12
- package/dist/src/browser/cookies.js +19 -19
- package/dist/src/browser/detect.js +62 -62
- package/dist/src/browser/domDebug.js +1 -1
- package/dist/src/browser/index.js +390 -295
- package/dist/src/browser/modelStrategy.js +1 -1
- package/dist/src/browser/pageActions.js +5 -5
- package/dist/src/browser/policies.js +16 -13
- package/dist/src/browser/profileState.js +44 -39
- package/dist/src/browser/prompt.js +72 -42
- package/dist/src/browser/promptSummary.js +5 -5
- package/dist/src/browser/providerDomFlow.js +1 -1
- package/dist/src/browser/providers/chatgptDomProvider.js +9 -9
- package/dist/src/browser/providers/geminiDeepThinkDomProvider.js +51 -42
- package/dist/src/browser/providers/index.js +2 -2
- package/dist/src/browser/reattach.js +67 -34
- package/dist/src/browser/reattachHelpers.js +31 -26
- package/dist/src/browser/sessionRunner.js +37 -25
- package/dist/src/browser/utils.js +9 -9
- package/dist/src/browserMode.js +1 -1
- package/dist/src/cli/bridge/claudeConfig.js +16 -16
- package/dist/src/cli/bridge/client.js +28 -20
- package/dist/src/cli/bridge/codexConfig.js +16 -16
- package/dist/src/cli/bridge/doctor.js +47 -39
- package/dist/src/cli/bridge/host.js +58 -56
- package/dist/src/cli/browserConfig.js +62 -48
- package/dist/src/cli/browserDefaults.js +27 -26
- package/dist/src/cli/bundleWarnings.js +1 -1
- package/dist/src/cli/clipboard.js +11 -2
- package/dist/src/cli/detach.js +2 -2
- package/dist/src/cli/dryRun.js +29 -25
- package/dist/src/cli/duplicatePromptGuard.js +3 -3
- package/dist/src/cli/engine.js +9 -9
- package/dist/src/cli/errorUtils.js +1 -1
- package/dist/src/cli/fileSize.js +3 -3
- package/dist/src/cli/format.js +2 -2
- package/dist/src/cli/help.js +28 -28
- package/dist/src/cli/hiddenAliases.js +3 -3
- package/dist/src/cli/markdownBundle.js +7 -7
- package/dist/src/cli/markdownRenderer.js +15 -15
- package/dist/src/cli/notifier.js +77 -67
- package/dist/src/cli/options.js +127 -106
- package/dist/src/cli/oscUtils.js +1 -1
- package/dist/src/cli/promptRequirement.js +2 -2
- package/dist/src/cli/renderOutput.js +1 -1
- package/dist/src/cli/rootAlias.js +1 -1
- package/dist/src/cli/runOptions.js +32 -28
- package/dist/src/cli/sessionCommand.js +31 -21
- package/dist/src/cli/sessionDisplay.js +95 -81
- package/dist/src/cli/sessionLineage.js +6 -2
- package/dist/src/cli/sessionRunner.js +103 -93
- package/dist/src/cli/sessionTable.js +26 -23
- package/dist/src/cli/stdin.js +22 -0
- package/dist/src/cli/tagline.js +121 -124
- package/dist/src/cli/tui/index.js +139 -128
- package/dist/src/cli/writeOutputPath.js +5 -5
- package/dist/src/config.js +7 -7
- package/dist/src/gemini-web/browserSessionManager.js +19 -15
- package/dist/src/gemini-web/client.js +76 -70
- package/dist/src/gemini-web/executionMode.js +6 -8
- package/dist/src/gemini-web/executor.js +98 -93
- package/dist/src/gemini-web/index.js +1 -1
- package/dist/src/mcp/server.js +16 -12
- package/dist/src/mcp/tools/consult.js +51 -47
- package/dist/src/mcp/tools/sessionResources.js +12 -12
- package/dist/src/mcp/tools/sessions.js +26 -17
- package/dist/src/mcp/types.js +5 -5
- package/dist/src/mcp/utils.js +15 -7
- package/dist/src/oracle/background.js +15 -15
- package/dist/src/oracle/claude.js +53 -25
- package/dist/src/oracle/client.js +50 -41
- package/dist/src/oracle/config.js +96 -66
- package/dist/src/oracle/errors.js +38 -38
- package/dist/src/oracle/files.js +55 -46
- package/dist/src/oracle/finishLine.js +10 -8
- package/dist/src/oracle/format.js +3 -3
- package/dist/src/oracle/gemini.js +37 -33
- package/dist/src/oracle/logging.js +7 -7
- package/dist/src/oracle/markdown.js +28 -28
- package/dist/src/oracle/modelResolver.js +16 -16
- package/dist/src/oracle/multiModelRunner.js +12 -12
- package/dist/src/oracle/oscProgress.js +8 -8
- package/dist/src/oracle/promptAssembly.js +6 -3
- package/dist/src/oracle/request.js +16 -13
- package/dist/src/oracle/run.js +156 -134
- package/dist/src/oracle/runUtils.js +8 -5
- package/dist/src/oracle/tokenEstimate.js +6 -6
- package/dist/src/oracle/tokenStats.js +5 -5
- package/dist/src/oracle/tokenStringifier.js +5 -5
- package/dist/src/oracle.js +12 -12
- package/dist/src/oracleHome.js +3 -3
- package/dist/src/remote/client.js +25 -25
- package/dist/src/remote/health.js +20 -20
- package/dist/src/remote/remoteServiceConfig.js +9 -9
- package/dist/src/remote/server.js +129 -118
- package/dist/src/sessionManager.js +77 -75
- package/dist/src/sessionStore.js +3 -3
- package/dist/src/version.js +10 -10
- package/dist/vendor/oracle-notifier/README.md +2 -0
- package/package.json +66 -62
- package/vendor/oracle-notifier/README.md +2 -0
- package/dist/markdansi/types/index.js +0 -4
- package/dist/oracle/bin/oracle-cli.js +0 -472
- package/dist/oracle/src/browser/actions/assistantResponse.js +0 -471
- package/dist/oracle/src/browser/actions/attachments.js +0 -82
- package/dist/oracle/src/browser/actions/modelSelection.js +0 -190
- package/dist/oracle/src/browser/actions/navigation.js +0 -75
- package/dist/oracle/src/browser/actions/promptComposer.js +0 -167
- package/dist/oracle/src/browser/chromeLifecycle.js +0 -104
- package/dist/oracle/src/browser/config.js +0 -33
- package/dist/oracle/src/browser/constants.js +0 -40
- package/dist/oracle/src/browser/cookies.js +0 -210
- package/dist/oracle/src/browser/domDebug.js +0 -36
- package/dist/oracle/src/browser/index.js +0 -331
- package/dist/oracle/src/browser/pageActions.js +0 -5
- package/dist/oracle/src/browser/prompt.js +0 -88
- package/dist/oracle/src/browser/promptSummary.js +0 -20
- package/dist/oracle/src/browser/sessionRunner.js +0 -80
- package/dist/oracle/src/browser/types.js +0 -1
- package/dist/oracle/src/browser/utils.js +0 -62
- package/dist/oracle/src/browserMode.js +0 -1
- package/dist/oracle/src/cli/browserConfig.js +0 -44
- package/dist/oracle/src/cli/dryRun.js +0 -59
- package/dist/oracle/src/cli/engine.js +0 -17
- package/dist/oracle/src/cli/errorUtils.js +0 -9
- package/dist/oracle/src/cli/help.js +0 -70
- package/dist/oracle/src/cli/markdownRenderer.js +0 -15
- package/dist/oracle/src/cli/options.js +0 -103
- package/dist/oracle/src/cli/promptRequirement.js +0 -14
- package/dist/oracle/src/cli/rootAlias.js +0 -30
- package/dist/oracle/src/cli/sessionCommand.js +0 -77
- package/dist/oracle/src/cli/sessionDisplay.js +0 -270
- package/dist/oracle/src/cli/sessionRunner.js +0 -94
- package/dist/oracle/src/heartbeat.js +0 -43
- package/dist/oracle/src/oracle/client.js +0 -48
- package/dist/oracle/src/oracle/config.js +0 -29
- package/dist/oracle/src/oracle/errors.js +0 -101
- package/dist/oracle/src/oracle/files.js +0 -220
- package/dist/oracle/src/oracle/format.js +0 -33
- package/dist/oracle/src/oracle/fsAdapter.js +0 -7
- package/dist/oracle/src/oracle/oscProgress.js +0 -60
- package/dist/oracle/src/oracle/request.js +0 -48
- package/dist/oracle/src/oracle/run.js +0 -444
- package/dist/oracle/src/oracle/tokenStats.js +0 -39
- package/dist/oracle/src/oracle/types.js +0 -1
- package/dist/oracle/src/oracle.js +0 -9
- package/dist/oracle/src/sessionManager.js +0 -205
- package/dist/oracle/src/version.js +0 -39
- package/dist/scripts/chrome/browser-tools.js +0 -295
- package/dist/src/browser/profileSync.js +0 -141
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -11,11 +11,11 @@
|
|
|
11
11
|
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="MIT License"></a>
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
|
-
Oracle bundles your prompt and files so another AI can answer with real context. It speaks GPT-5.
|
|
14
|
+
Oracle bundles your prompt and files so another AI can answer with real context. It speaks GPT-5.5 Pro (default), GPT-5.5, GPT-5.4 Pro, GPT-5.4, GPT-5.1 Pro, GPT-5.1 Codex (API-only), GPT-5.1, GPT-5.2, Gemini 3.1 Pro (API-only), Gemini 3 Pro, Claude Sonnet 4.6, Claude Opus 4.1, and more—and it can ask one or multiple models in a single run. Browser automation is available; use `--browser-model-strategy current` to keep the active ChatGPT model (or `ignore` to skip the picker). API remains the most reliable path, and `--copy` is an easy manual fallback.
|
|
15
15
|
|
|
16
16
|
## Setting up (macOS Browser Mode)
|
|
17
17
|
|
|
18
|
-
Browser mode lets you use GPT-5.
|
|
18
|
+
Browser mode lets you use GPT-5.5 Pro without any API keys — it automates your Chrome browser directly.
|
|
19
19
|
|
|
20
20
|
### First-time login
|
|
21
21
|
|
|
@@ -40,6 +40,7 @@ oracle --engine browser --browser-manual-login \
|
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
> **Why these flags?**
|
|
43
|
+
>
|
|
43
44
|
> - `--browser-manual-login` — Skips macOS Keychain cookie access (avoids repeated permission popups)
|
|
44
45
|
> - `--browser-auto-reattach-*` — Reconnects when ChatGPT redirects mid-page-load (fixes "Inspected target navigated or closed" error)
|
|
45
46
|
> - `--browser-keep-browser` — Keeps browser open for first-time login (not needed after)
|
|
@@ -91,7 +92,8 @@ Engine auto-picks API when `OPENAI_API_KEY` is set, otherwise browser; browser i
|
|
|
91
92
|
## Integration
|
|
92
93
|
|
|
93
94
|
**CLI**
|
|
94
|
-
|
|
95
|
+
|
|
96
|
+
- API mode expects API keys in your environment: `OPENAI_API_KEY` (GPT-5.x), `GEMINI_API_KEY` (Gemini 3.1 Pro / Gemini 3 Pro), `ANTHROPIC_API_KEY` (Claude Sonnet 4.6 / Opus 4.1).
|
|
95
97
|
- Gemini browser mode uses Chrome cookies instead of an API key—just be logged into `gemini.google.com` in Chrome (no Python/venv required).
|
|
96
98
|
- If your Gemini account can’t access “Pro”, Oracle auto-falls back to a supported model for web runs (and logs the fallback in verbose mode).
|
|
97
99
|
- Prefer API mode or `--copy` + manual paste; browser automation is experimental.
|
|
@@ -105,19 +107,23 @@ Engine auto-picks API when `OPENAI_API_KEY` is set, otherwise browser; browser i
|
|
|
105
107
|
- Tip: set `browser.chatgptUrl` in config (or `--chatgpt-url`) to a dedicated ChatGPT project folder so browser runs don’t clutter your main history.
|
|
106
108
|
|
|
107
109
|
**Codex skill**
|
|
110
|
+
|
|
108
111
|
- Copy the bundled skill from this repo to your Codex skills folder:
|
|
109
112
|
- `mkdir -p ~/.codex/skills`
|
|
110
113
|
- `cp -R skills/oracle ~/.codex/skills/oracle`
|
|
111
114
|
- Then reference it in your `AGENTS.md`/`CLAUDE.md` so Codex loads it.
|
|
112
115
|
|
|
113
116
|
**MCP**
|
|
117
|
+
|
|
114
118
|
- Run the stdio server via `oracle-mcp`.
|
|
115
119
|
- Configure clients via [steipete/mcporter](https://github.com/steipete/mcporter) or `.mcp.json`; see [docs/mcp.md](docs/mcp.md) for connection examples.
|
|
120
|
+
|
|
116
121
|
```bash
|
|
117
122
|
npx -y @steipete/oracle oracle-mcp
|
|
118
123
|
```
|
|
124
|
+
|
|
119
125
|
- 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.
|
|
120
|
-
[](https://cursor.com/en-US/install-mcp?name=oracle&config=eyJjb21tYW5kIjoibnB4IC15IEBzdGVpcGV0ZS9vcmFjbGUgb3JhY2xlLW1jcCJ9)
|
|
126
|
+
[](https://cursor.com/en-US/install-mcp?name=oracle&config=eyJjb21tYW5kIjoibnB4IC15IEBzdGVpcGV0ZS9vcmFjbGUgb3JhY2xlLW1jcCJ9)
|
|
121
127
|
|
|
122
128
|
```json
|
|
123
129
|
{
|
|
@@ -176,6 +182,7 @@ pending gpt-5.2-pro api 03/01/2026 09:25 AM 900 - └─ archit
|
|
|
176
182
|
When browser runs time out (common with long GPT‑5.x Pro responses), Oracle can keep polling the existing ChatGPT tab and capture the final answer without manual `oracle session <id>` commands.
|
|
177
183
|
|
|
178
184
|
Enable auto-reattach by setting a non-zero interval:
|
|
185
|
+
|
|
179
186
|
- `--browser-auto-reattach-delay` — wait before the first retry (e.g. `30s`)
|
|
180
187
|
- `--browser-auto-reattach-interval` — how often to retry (e.g. `2m`)
|
|
181
188
|
- `--browser-auto-reattach-timeout` — per-attempt budget (default `2m`)
|
|
@@ -191,68 +198,71 @@ oracle --engine browser \
|
|
|
191
198
|
|
|
192
199
|
## Flags you’ll actually use
|
|
193
200
|
|
|
194
|
-
| Flag
|
|
195
|
-
|
|
|
196
|
-
| `-p, --prompt <text>`
|
|
197
|
-
| `-f, --file <paths...>`
|
|
198
|
-
| `-e, --engine <api\|browser>`
|
|
199
|
-
| `-m, --model <name>`
|
|
200
|
-
| `--models <list>`
|
|
201
|
-
| `--followup <sessionId\|responseId>`
|
|
202
|
-
| `--followup-model <model>`
|
|
203
|
-
| `--base-url <url>`
|
|
204
|
-
| `--chatgpt-url <url>`
|
|
205
|
-
| `--browser-model-strategy <select\|current\|ignore>`
|
|
206
|
-
| `--browser-manual-login`
|
|
207
|
-
| `--browser-thinking-time <light\|standard\|extended\|heavy>`
|
|
208
|
-
| `--browser-port <port>`
|
|
209
|
-
| `--browser-inline-cookies[(-file)] <payload
|
|
210
|
-
| `--browser-timeout`, `--browser-input-timeout`
|
|
211
|
-
| `--browser-recheck-delay`, `--browser-recheck-timeout`
|
|
212
|
-
| `--browser-reuse-wait`
|
|
213
|
-
| `--browser-profile-lock-timeout`
|
|
214
|
-
| `--render`, `--copy`
|
|
215
|
-
| `--wait`
|
|
216
|
-
| `--timeout <seconds\|auto>`
|
|
217
|
-
| `--background`, `--no-background`
|
|
218
|
-
| `--http-timeout <ms\|s\|m\|h>`
|
|
219
|
-
| `--zombie-timeout <ms\|s\|m\|h>`
|
|
220
|
-
| `--zombie-last-activity`
|
|
221
|
-
| `--write-output <path>`
|
|
222
|
-
| `--files-report`
|
|
223
|
-
| `--dry-run [summary\|json\|full]`
|
|
224
|
-
| `--remote-host`, `--remote-token`
|
|
225
|
-
| `--remote-chrome <host:port>`
|
|
226
|
-
| `--youtube <url>`
|
|
227
|
-
| `--generate-image <file>`
|
|
228
|
-
| `--edit-image <file>`
|
|
229
|
-
| `--azure-endpoint`, `--azure-deployment`, `--azure-api-version` | Target Azure OpenAI endpoints (picks Azure client automatically).
|
|
201
|
+
| Flag | Purpose |
|
|
202
|
+
| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
203
|
+
| `-p, --prompt <text>` | Required prompt. |
|
|
204
|
+
| `-f, --file <paths...>` | Attach files/dirs (globs + `!` excludes). |
|
|
205
|
+
| `-e, --engine <api\|browser>` | Choose API or browser (browser is experimental). |
|
|
206
|
+
| `-m, --model <name>` | Built-ins (`gpt-5.5-pro` default, `gpt-5.5`, `gpt-5.4-pro`, `gpt-5.4`, `gpt-5.1-pro`, `gpt-5-pro`, `gpt-5.1`, `gpt-5.1-codex`, `gpt-5.2`, `gpt-5.2-instant`, `gpt-5.2-pro`, `gemini-3.1-pro` API-only, `gemini-3-pro`, `claude-4.6-sonnet`, `claude-4.1-opus`) plus any OpenRouter id (e.g., `minimax/minimax-m2`, `openai/gpt-4o-mini`). |
|
|
207
|
+
| `--models <list>` | Comma-separated API models (mix built-ins and OpenRouter ids) for multi-model runs. |
|
|
208
|
+
| `--followup <sessionId\|responseId>` | Continue an OpenAI/Azure Responses API run from a stored oracle session or `resp_...` response id. |
|
|
209
|
+
| `--followup-model <model>` | For multi-model OpenAI/Azure parent sessions, choose which model response to continue from. |
|
|
210
|
+
| `--base-url <url>` | Point API runs at LiteLLM/Azure/OpenRouter/etc. |
|
|
211
|
+
| `--chatgpt-url <url>` | Target a ChatGPT workspace/folder (browser). |
|
|
212
|
+
| `--browser-model-strategy <select\|current\|ignore>` | Control ChatGPT model selection in browser mode (current keeps the active model; ignore skips the picker). |
|
|
213
|
+
| `--browser-manual-login` | Skip cookie copy; reuse a persistent automation profile and wait for manual ChatGPT login. |
|
|
214
|
+
| `--browser-thinking-time <light\|standard\|extended\|heavy>` | Set ChatGPT thinking-time intensity (browser; Thinking/Pro models only). |
|
|
215
|
+
| `--browser-port <port>` | Pin the Chrome DevTools port (WSL/Windows firewall helper). |
|
|
216
|
+
| `--browser-inline-cookies[(-file)] <payload \| path>` | Supply cookies without Chrome/Keychain (browser). |
|
|
217
|
+
| `--browser-timeout`, `--browser-input-timeout` | Control overall/browser input timeouts (supports h/m/s/ms). |
|
|
218
|
+
| `--browser-recheck-delay`, `--browser-recheck-timeout` | Delayed recheck for long Pro runs: wait then retry capture after timeout (supports h/m/s/ms). |
|
|
219
|
+
| `--browser-reuse-wait` | Wait for a shared Chrome profile before launching (parallel browser runs). |
|
|
220
|
+
| `--browser-profile-lock-timeout` | Wait for the shared manual-login profile lock before sending (serializes parallel runs). |
|
|
221
|
+
| `--render`, `--copy` | Print and/or copy the assembled markdown bundle. |
|
|
222
|
+
| `--wait` | Block for background API runs (e.g., GPT‑5.1 Pro) instead of detaching. |
|
|
223
|
+
| `--timeout <seconds\|auto>` | Overall API deadline (auto = 60m for pro, 120s otherwise). |
|
|
224
|
+
| `--background`, `--no-background` | Force Responses API background mode (create + retrieve) for API runs. |
|
|
225
|
+
| `--http-timeout <ms\|s\|m\|h>` | HTTP client timeout (default 20m). |
|
|
226
|
+
| `--zombie-timeout <ms\|s\|m\|h>` | Override stale-session cutoff used by `oracle status`. |
|
|
227
|
+
| `--zombie-last-activity` | Use last log activity to detect stale sessions. |
|
|
228
|
+
| `--write-output <path>` | Save only the final answer (multi-model adds `.<model>`). |
|
|
229
|
+
| `--files-report` | Print per-file token usage. |
|
|
230
|
+
| `--dry-run [summary\|json\|full]` | Preview without sending. |
|
|
231
|
+
| `--remote-host`, `--remote-token` | Use a remote `oracle serve` host (browser). |
|
|
232
|
+
| `--remote-chrome <host:port>` | Attach to an existing remote Chrome session (browser). |
|
|
233
|
+
| `--youtube <url>` | YouTube video URL to analyze (Gemini browser mode). |
|
|
234
|
+
| `--generate-image <file>` | Generate image and save to file (Gemini browser mode). |
|
|
235
|
+
| `--edit-image <file>` | Edit existing image with `--output` (Gemini browser mode). |
|
|
236
|
+
| `--azure-endpoint`, `--azure-deployment`, `--azure-api-version` | Target Azure OpenAI endpoints (picks Azure client automatically). |
|
|
230
237
|
|
|
231
238
|
## Configuration
|
|
232
239
|
|
|
233
240
|
Put defaults in `~/.oracle/config.json` (JSON5). Example:
|
|
241
|
+
|
|
234
242
|
```json5
|
|
235
243
|
{
|
|
236
|
-
model: "gpt-5.
|
|
244
|
+
model: "gpt-5.5-pro",
|
|
237
245
|
engine: "api",
|
|
238
246
|
filesReport: true,
|
|
239
247
|
browser: {
|
|
240
|
-
chatgptUrl: "https://chatgpt.com/g/g-p-691edc9fec088191b553a35093da1ea8-oracle/project"
|
|
241
|
-
}
|
|
248
|
+
chatgptUrl: "https://chatgpt.com/g/g-p-691edc9fec088191b553a35093da1ea8-oracle/project",
|
|
249
|
+
},
|
|
242
250
|
}
|
|
243
251
|
```
|
|
252
|
+
|
|
244
253
|
Use `browser.chatgptUrl` (or the legacy alias `browser.url`) to target a specific ChatGPT workspace/folder for browser automation.
|
|
245
254
|
See [docs/configuration.md](docs/configuration.md) for precedence and full schema.
|
|
246
255
|
|
|
247
256
|
Advanced flags
|
|
248
257
|
|
|
249
|
-
| Area
|
|
250
|
-
|
|
|
251
|
-
| Browser
|
|
252
|
-
| Run control
|
|
253
|
-
| Azure/OpenAI | `--azure-endpoint`, `--azure-deployment`, `--azure-api-version`, `--base-url`
|
|
258
|
+
| Area | Flags |
|
|
259
|
+
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
260
|
+
| Browser | `--browser-manual-login`, `--browser-thinking-time`, `--browser-timeout`, `--browser-input-timeout`, `--browser-recheck-delay`, `--browser-recheck-timeout`, `--browser-reuse-wait`, `--browser-profile-lock-timeout`, `--browser-auto-reattach-delay`, `--browser-auto-reattach-interval`, `--browser-auto-reattach-timeout`, `--browser-cookie-wait`, `--browser-inline-cookies[(-file)]`, `--browser-attachments`, `--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` |
|
|
261
|
+
| Run control | `--background`, `--no-background`, `--http-timeout`, `--zombie-timeout`, `--zombie-last-activity` |
|
|
262
|
+
| Azure/OpenAI | `--azure-endpoint`, `--azure-deployment`, `--azure-api-version`, `--base-url` |
|
|
254
263
|
|
|
255
264
|
Remote browser example
|
|
265
|
+
|
|
256
266
|
```bash
|
|
257
267
|
# Host (signed-in Chrome): launch serve
|
|
258
268
|
oracle serve --host 0.0.0.0:9473 --token secret123
|
|
@@ -265,12 +275,14 @@ oracle --engine browser --browser-inline-cookies-file ~/.oracle/cookies.json -p
|
|
|
265
275
|
```
|
|
266
276
|
|
|
267
277
|
Session management
|
|
278
|
+
|
|
268
279
|
```bash
|
|
269
280
|
# Prune stored sessions (default path ~/.oracle/sessions; override ORACLE_HOME_DIR)
|
|
270
281
|
oracle status --clear --hours 168
|
|
271
282
|
```
|
|
272
283
|
|
|
273
284
|
## More docs
|
|
285
|
+
|
|
274
286
|
- Bridge (Windows host → Linux client): [docs/bridge.md](docs/bridge.md)
|
|
275
287
|
- 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)
|
|
276
288
|
- MCP: [docs/mcp.md](docs/mcp.md)
|
|
@@ -282,6 +294,7 @@ If you’re looking for an even more powerful context-management tool, check out
|
|
|
282
294
|
Name inspired by: https://ampcode.com/news/oracle
|
|
283
295
|
|
|
284
296
|
## More free stuff from steipete
|
|
297
|
+
|
|
285
298
|
- ✂️ [Trimmy](https://trimmy.app) — “Paste once, run once.” Flatten multi-line shell snippets so they paste and run.
|
|
286
299
|
- 🟦🟩 [CodexBar](https://codexbar.app) — Keep Codex token windows visible in your macOS menu bar.
|
|
287
300
|
- 🧳 [MCPorter](https://mcporter.dev) — TypeScript toolkit + CLI for Model Context Protocol servers.
|