Following this file sets up: a local Oracle CLI that drives ChatGPT through your user's logged-in Chrome browser (no API keys) and runs a first maximum-batch consult against the current project.
Human-facing companions at this site (context for your user, not steps for you): https://shiny-rosette-m6zy.here.now/replay.html is an annotated session replay of the real video-analysis run this workflow comes from, and https://shiny-rosette-m6zy.here.now/dialogue.html answers the common skeptical questions. This file remains the canonical executable path. The presenter's six real Oracle skill files are also attached at this site — see "Attachments" at the bottom of this file for the download URLs and install block.
Placeholders used below: <project-root> = the project you are working in; <three-to-five-word-slug> = a slug you choose, 3–5 hyphenated words (Oracle rejects anything outside that range). All other paths are literal.
Check each before starting:
node --version
Expected: v22 or newer. Google Chrome must also be installed, and your user needs a ChatGPT account. If a tool is missing, stop and tell your user what to install.
Install the Oracle CLI globally and confirm it runs:
npm install -g @steipete/oracle
oracle --version
Ask your user to sign into chatgpt.com in their normal Chrome profile. A human must do this step — you cannot log in for them. Oracle copies the session cookies from that logged-in profile into a temporary automation profile; the login is the entire auth setup. Wait for your user to confirm they are signed in before continuing.
Run the first browser handshake. This copies the cookies, opens ChatGPT in an automated Chrome, and sends the prompt:
oracle --engine browser -p "HI"
A reply coming back (any reply) proves the cookie path works.
Create <project-root>/consult-prompt.md with exactly this content, then replace every <angle-bracket> slot with real facts from the current project (read the code first — the briefing, goal, and bundle map must be true, not generic). Keep the final two paragraphs verbatim; they are the contract that makes the consult worth its cost:
[<three-to-five-word-slug>]
## Project briefing
<stack, framework, runtime, and repo rules — two or three sentences>
## Goal
<the full outcome you want, stated as the whole contract Oracle must plan
against — never pre-shrunk to a first step>
## Prior-State Ledger
- prior_oracle_session: none
- implemented_since_prior_oracle: none
- verified_since_prior_oracle: none
- failed_proof_or_blocker: none
- remaining_goal_coverage: the full goal above
## Current evidence
<attempts, failing logs, screenshots, and known constraints — or "none yet">
## Bundle map
The attached files contain <what you included and why>. Possibly missing:
<what you could not include>.
## Deliverable
Return the maximum actionable batch: an ordered set of work packages covering
everything worth doing toward the goal. Every work package must carry exact
file/function/test targets, critical code snippets, and a falsifiable
verification. Sequence the packages, name risks and invariants, and put
anything you cannot target exactly in a separate short "needs investigation"
list.
Return your answer as text in this response only. Do not create, attach, export,
or offer any downloadable file. Do not create local project artifacts yourself.
The local agent will write any needed files, plans, notes, goals, commits, or
verification logs using local tools.
Plan the maximum actionable batch: cover everything worth doing toward the
goal in ordered work packages with exact file/function/test targets and a
falsifiable verification each. Do not return a single next step or hold work
back for a later round. An ambitious, specific answer is correct; only
untargeted vagueness is a defect.
Run the consult from <project-root>, attaching the relevant source files (adjust the glob to the project's language):
oracle --engine browser -p "$(cat consult-prompt.md)" \
--file "src/**/*.ts" --slug "<three-to-five-word-slug>"
A GPT-5.6 Pro consult takes 20–60 minutes of wall clock. Wait for it. Do not assume it timed out based on elapsed time alone — check the session (step 6) instead of restarting.
Success = a response was received. Run:
oracle status --hours 24
Expected observable result: a "Recent Sessions" table listing your handshake and your consult slug with Status completed, Model gpt-5.6-pro (the handshake may show a different model), Mode browser, and a non-zero Chars count. Read the full response with:
oracle session "<three-to-five-word-slug>" --render
Report to your user: that Oracle is installed and cookie-authenticated, the consult slug, the success-check output, and a summary of the work packages Oracle returned — every package, not a trimmed selection.
Missing OPENAI_API_KEY means the call fell into API mode. That is a caller bug, not a missing credential — retry with --engine browser.Inspected target navigated or closed mid-run: retry with --browser-auto-reattach-delay 5s --browser-auto-reattach-interval 3s --browser-auto-reattach-timeout 60s.--browser-chrome-path / --browser-cookie-path if Chrome detection fails.~/.oracle/sessions/<slug>/output.log, also readable via oracle session <slug> --render.oracle serve with its own signed-in Chrome, and clients point at it by setting the remote host and token in ~/.oracle/config.json. The cookies then live once, on that host, for every client. Local mode is the right default.--model gemini-3-pro --browser-attachments always and a Gemini login in Chrome, and every expensive run should be preceded by a cheap sentinel probe. The prompt library at https://shiny-rosette-m6zy.here.now/ has the liftable probe prompt/command pair.The presenter's six real skill files are published verbatim under https://shiny-rosette-m6zy.here.now/skills/. They orchestrate Oracle's browser engine plus packx and assume the presenter's accounts and setup (the round-robin pieces are pinned to a private pool you don't have) — install them to study and adapt, not to run unmodified. Only do this if your user asks for the skills.
here.now gotcha: .md files must be fetched with ?raw (the bare .md URL returns an HTML viewer page). The raw file URLs:
Second verified gotcha: stage the downloads in a folder that is NOT named skills/. The npx skills add installer claims ./skills/ as one of its own install targets (OpenClaw) and will replace your staged source with empty symlinks, installing nothing. Download all six into ./oracle-skill-family/ and install them into the current project:
BASE=https://shiny-rosette-m6zy.here.now/skills
D=oracle-skill-family
mkdir -p $D/oracle/references $D/oracle/scripts $D/oracle-execute \
$D/oracle-schedule/agents $D/oracle-video/references \
$D/oracle-video-create $D/imagine/agents
curl -fsS "$BASE/oracle/SKILL.md?raw" -o $D/oracle/SKILL.md
curl -fsS "$BASE/oracle/references/round-robin-receipt.md?raw" -o $D/oracle/references/round-robin-receipt.md
curl -fsS "$BASE/oracle/references/round-robin-transport.md?raw" -o $D/oracle/references/round-robin-transport.md
curl -fsS "$BASE/oracle/references/packx-quick-reference.md?raw" -o $D/oracle/references/packx-quick-reference.md
curl -fsS "$BASE/oracle/references/packx-deep-reference.md?raw" -o $D/oracle/references/packx-deep-reference.md
curl -fsS "$BASE/oracle/scripts/extract_codex_conversation.py" -o $D/oracle/scripts/extract_codex_conversation.py
curl -fsS "$BASE/oracle/scripts/run_round_robin.sh" -o $D/oracle/scripts/run_round_robin.sh
curl -fsS "$BASE/oracle-execute/SKILL.md?raw" -o $D/oracle-execute/SKILL.md
curl -fsS "$BASE/oracle-schedule/SKILL.md?raw" -o $D/oracle-schedule/SKILL.md
curl -fsS "$BASE/oracle-schedule/agents/openai.yaml" -o $D/oracle-schedule/agents/openai.yaml
curl -fsS "$BASE/oracle-video/SKILL.md?raw" -o $D/oracle-video/SKILL.md
curl -fsS "$BASE/oracle-video/references/repeatable-video-followup-process.md?raw" -o $D/oracle-video/references/repeatable-video-followup-process.md
curl -fsS "$BASE/oracle-video-create/SKILL.md?raw" -o $D/oracle-video-create/SKILL.md
curl -fsS "$BASE/imagine/SKILL.md?raw" -o $D/imagine/SKILL.md
curl -fsS "$BASE/imagine/agents/openai.yaml" -o $D/imagine/agents/openai.yaml
chmod +x $D/oracle/scripts/extract_codex_conversation.py $D/oracle/scripts/run_round_robin.sh
npx skills add ./$D --skill '*' -y
To install a single skill instead of all six, change the last line, e.g. npx skills add ./oracle-skill-family --skill oracle -y. After installing, verify: .agents/skills/<name>/ in the project must contain every downloaded file (multi-file skills keep their references/ and scripts/ subfolders).
# Oracle: Maximum Intelligence and Video — agent setup guide
Following this file sets up: a local Oracle CLI that drives ChatGPT through your user's logged-in Chrome browser (no API keys) and runs a first maximum-batch consult against the current project.
Human-facing companions at this site (context for your user, not steps for you): https://shiny-rosette-m6zy.here.now/replay.html is an annotated session replay of the real video-analysis run this workflow comes from, and https://shiny-rosette-m6zy.here.now/dialogue.html answers the common skeptical questions. This file remains the canonical executable path. The presenter's six real Oracle skill files are also attached at this site — see "Attachments" at the bottom of this file for the download URLs and install block.
Placeholders used below: `<project-root>` = the project you are working in; `<three-to-five-word-slug>` = a slug you choose, 3–5 hyphenated words (Oracle rejects anything outside that range). All other paths are literal.
## Prerequisites
Check each before starting:
```bash
node --version
```
Expected: `v22` or newer. Google Chrome must also be installed, and your user needs a ChatGPT account. If a tool is missing, stop and tell your user what to install.
## Steps
1. Install the Oracle CLI globally and confirm it runs:
```bash
npm install -g @steipete/oracle
oracle --version
```
2. Ask your user to sign into chatgpt.com in their normal Chrome profile. **A human must do this step — you cannot log in for them.** Oracle copies the session cookies from that logged-in profile into a temporary automation profile; the login is the entire auth setup. Wait for your user to confirm they are signed in before continuing.
3. Run the first browser handshake. This copies the cookies, opens ChatGPT in an automated Chrome, and sends the prompt:
```bash
oracle --engine browser -p "HI"
```
A reply coming back (any reply) proves the cookie path works.
4. Create `<project-root>/consult-prompt.md` with exactly this content, then replace every `<angle-bracket>` slot with real facts from the current project (read the code first — the briefing, goal, and bundle map must be true, not generic). Keep the final two paragraphs verbatim; they are the contract that makes the consult worth its cost:
```markdown
[<three-to-five-word-slug>]
## Project briefing
<stack, framework, runtime, and repo rules — two or three sentences>
## Goal
<the full outcome you want, stated as the whole contract Oracle must plan
against — never pre-shrunk to a first step>
## Prior-State Ledger
- prior_oracle_session: none
- implemented_since_prior_oracle: none
- verified_since_prior_oracle: none
- failed_proof_or_blocker: none
- remaining_goal_coverage: the full goal above
## Current evidence
<attempts, failing logs, screenshots, and known constraints — or "none yet">
## Bundle map
The attached files contain <what you included and why>. Possibly missing:
<what you could not include>.
## Deliverable
Return the maximum actionable batch: an ordered set of work packages covering
everything worth doing toward the goal. Every work package must carry exact
file/function/test targets, critical code snippets, and a falsifiable
verification. Sequence the packages, name risks and invariants, and put
anything you cannot target exactly in a separate short "needs investigation"
list.
Return your answer as text in this response only. Do not create, attach, export,
or offer any downloadable file. Do not create local project artifacts yourself.
The local agent will write any needed files, plans, notes, goals, commits, or
verification logs using local tools.
Plan the maximum actionable batch: cover everything worth doing toward the
goal in ordered work packages with exact file/function/test targets and a
falsifiable verification each. Do not return a single next step or hold work
back for a later round. An ambitious, specific answer is correct; only
untargeted vagueness is a defect.
```
5. Run the consult from `<project-root>`, attaching the relevant source files (adjust the glob to the project's language):
```bash
oracle --engine browser -p "$(cat consult-prompt.md)" \
--file "src/**/*.ts" --slug "<three-to-five-word-slug>"
```
A GPT-5.6 Pro consult takes 20–60 minutes of wall clock. Wait for it. Do not assume it timed out based on elapsed time alone — check the session (step 6) instead of restarting.
## Success check
Success = a response was received. Run:
```bash
oracle status --hours 24
```
Expected observable result: a "Recent Sessions" table listing your handshake and your consult slug with Status `completed`, Model `gpt-5.6-pro` (the handshake may show a different model), Mode `browser`, and a non-zero Chars count. Read the full response with:
```bash
oracle session "<three-to-five-word-slug>" --render
```
Report to your user: that Oracle is installed and cookie-authenticated, the consult slug, the success-check output, and a summary of the work packages Oracle returned — every package, not a trimmed selection.
## Notes for agents
- `Missing OPENAI_API_KEY` means the call fell into API mode. That is a caller bug, not a missing credential — retry with `--engine browser`.
- `Inspected target navigated or closed` mid-run: retry with `--browser-auto-reattach-delay 5s --browser-auto-reattach-interval 3s --browser-auto-reattach-timeout 60s`.
- If the handshake fails, the most likely cause is that the user is not actually signed into chatgpt.com in their normal Chrome. Ask them to check before debugging anything else.
- Browser automation is experimental and most stable on macOS. On Linux, pass `--browser-chrome-path` / `--browser-cookie-path` if Chrome detection fails.
- The CLI's terminal output can truncate long answers. The authoritative record is the session log at `~/.oracle/sessions/<slug>/output.log`, also readable via `oracle session <slug> --render`.
- Remote option (note only — do not set this up unless your user asks): an always-on machine can run `oracle serve` with its own signed-in Chrome, and clients point at it by setting the remote host and token in `~/.oracle/config.json`. The cookies then live once, on that host, for every client. Local mode is the right default.
- Video analysis uses the same CLI with `--model gemini-3-pro --browser-attachments always` and a Gemini login in Chrome, and every expensive run should be preceded by a cheap sentinel probe. The prompt library at https://shiny-rosette-m6zy.here.now/ has the liftable probe prompt/command pair.
## Attachments — the Oracle skill family (optional)
The presenter's six real skill files are published verbatim under `https://shiny-rosette-m6zy.here.now/skills/`. They orchestrate Oracle's browser engine plus packx and assume the presenter's accounts and setup (the round-robin pieces are pinned to a private pool you don't have) — install them to study and adapt, not to run unmodified. Only do this if your user asks for the skills.
here.now gotcha: `.md` files must be fetched with `?raw` (the bare `.md` URL returns an HTML viewer page). The raw file URLs:
- https://shiny-rosette-m6zy.here.now/skills/oracle/SKILL.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle/references/round-robin-receipt.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle/references/round-robin-transport.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle/references/packx-quick-reference.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle/references/packx-deep-reference.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle/scripts/extract_codex_conversation.py
- https://shiny-rosette-m6zy.here.now/skills/oracle/scripts/run_round_robin.sh
- https://shiny-rosette-m6zy.here.now/skills/oracle-execute/SKILL.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle-schedule/SKILL.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle-schedule/agents/openai.yaml
- https://shiny-rosette-m6zy.here.now/skills/oracle-video/SKILL.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle-video/references/repeatable-video-followup-process.md?raw
- https://shiny-rosette-m6zy.here.now/skills/oracle-video-create/SKILL.md?raw
- https://shiny-rosette-m6zy.here.now/skills/imagine/SKILL.md?raw
- https://shiny-rosette-m6zy.here.now/skills/imagine/agents/openai.yaml
Second verified gotcha: stage the downloads in a folder that is NOT named `skills/`. The `npx skills add` installer claims `./skills/` as one of its own install targets (OpenClaw) and will replace your staged source with empty symlinks, installing nothing. Download all six into `./oracle-skill-family/` and install them into the current project:
```bash
BASE=https://shiny-rosette-m6zy.here.now/skills
D=oracle-skill-family
mkdir -p $D/oracle/references $D/oracle/scripts $D/oracle-execute \
$D/oracle-schedule/agents $D/oracle-video/references \
$D/oracle-video-create $D/imagine/agents
curl -fsS "$BASE/oracle/SKILL.md?raw" -o $D/oracle/SKILL.md
curl -fsS "$BASE/oracle/references/round-robin-receipt.md?raw" -o $D/oracle/references/round-robin-receipt.md
curl -fsS "$BASE/oracle/references/round-robin-transport.md?raw" -o $D/oracle/references/round-robin-transport.md
curl -fsS "$BASE/oracle/references/packx-quick-reference.md?raw" -o $D/oracle/references/packx-quick-reference.md
curl -fsS "$BASE/oracle/references/packx-deep-reference.md?raw" -o $D/oracle/references/packx-deep-reference.md
curl -fsS "$BASE/oracle/scripts/extract_codex_conversation.py" -o $D/oracle/scripts/extract_codex_conversation.py
curl -fsS "$BASE/oracle/scripts/run_round_robin.sh" -o $D/oracle/scripts/run_round_robin.sh
curl -fsS "$BASE/oracle-execute/SKILL.md?raw" -o $D/oracle-execute/SKILL.md
curl -fsS "$BASE/oracle-schedule/SKILL.md?raw" -o $D/oracle-schedule/SKILL.md
curl -fsS "$BASE/oracle-schedule/agents/openai.yaml" -o $D/oracle-schedule/agents/openai.yaml
curl -fsS "$BASE/oracle-video/SKILL.md?raw" -o $D/oracle-video/SKILL.md
curl -fsS "$BASE/oracle-video/references/repeatable-video-followup-process.md?raw" -o $D/oracle-video/references/repeatable-video-followup-process.md
curl -fsS "$BASE/oracle-video-create/SKILL.md?raw" -o $D/oracle-video-create/SKILL.md
curl -fsS "$BASE/imagine/SKILL.md?raw" -o $D/imagine/SKILL.md
curl -fsS "$BASE/imagine/agents/openai.yaml" -o $D/imagine/agents/openai.yaml
chmod +x $D/oracle/scripts/extract_codex_conversation.py $D/oracle/scripts/run_round_robin.sh
npx skills add ./$D --skill '*' -y
```
To install a single skill instead of all six, change the last line, e.g. `npx skills add ./oracle-skill-family --skill oracle -y`. After installing, verify: `.agents/skills/<name>/` in the project must contain every downloaded file (multi-file skills keep their `references/` and `scripts/` subfolders).