| name | consult-oracle |
| description | Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches. Use when stuck on a very hard problem, when standard approaches have failed, when multiple debugging attempts haven't worked, or when the user says "ask the oracle", "consult oracle", "consult chatgpt", "I'm completely stuck", "I've tried everything", or "nothing is working". |
Consult Oracle
Consult ChatGPT Pro via ChatGPT browser automation for problems that resist standard approaches.
Configuration
The oracle reads from ~/.turbo/config.json:
{
"oracle": {
"chatgptUrl": "https://chatgpt.com/",
"chromeProfile": "Default"
}
}
| Key | Purpose | Default |
|---|
chatgptUrl | ChatGPT URL (e.g., a custom GPT project URL) | https://chatgpt.com/ |
chromeProfile | Chrome profile directory name | Default |
Step 1: Refresh Cookies
Before running the oracle, refresh ChatGPT cookies from Chrome. Requires timeout of 60000ms. A macOS Keychain password prompt will appear for the user.
python3 scripts/refresh_cookies.py
If the script reports session validation failure, the user needs to log into ChatGPT in Chrome first.
Step 2: Identify Key Files
Find the 2-5 files most relevant to the problem.
Step 3: Formulate the Question
Write a clear, specific problem description. Include what has already been tried and why it failed. Open with a short project briefing (stack, services, build steps). The more context, the better the response.
Step 4: Run the Oracle
Use a generous timeout (60 minutes / 3600000ms). The script loads chatgptUrl from ~/.turbo/config.json automatically. Generate a random tag and persist the response:
ORACLE_TAG=$(head -c 4 /dev/urandom | xxd -p) && mkdir -p .turbo/oracle
python3 scripts/run_oracle.py --prompt "<problem description>" --file <relevant files...> --write-output ".turbo/oracle/$ORACLE_TAG.txt"
Step 5: Synthesize
Read the response from .turbo/oracle/$ORACLE_TAG.txt. Summarize the key insights from the consultation. Cross-reference suggestions with official docs and peer open-source implementations before applying. Oracle suggestions are starting points, not guaranteed solutions.
