npm - @steipete/oracle - Versions diffs - 0.21.1 → 0.21.2 - Mend

@steipete/oracle 0.21.1 → 0.21.2

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.

Files changed (39) hide show

package/dist/bin/oracle-cli.js +6 -10
package/dist/src/browser/profileState.js +2 -0
package/package.json +10 -10
package/dist/docs-site/.nojekyll +0 -0
package/dist/docs-site/CNAME +0 -1
package/dist/docs-site/RELEASING.html +0 -403
package/dist/docs-site/advisor.html +0 -317
package/dist/docs-site/agents.html +0 -375
package/dist/docs-site/anthropic.html +0 -368
package/dist/docs-site/bridge.html +0 -421
package/dist/docs-site/browser-mode.html +0 -637
package/dist/docs-site/chromium-forks.html +0 -355
package/dist/docs-site/cli-reference.html +0 -347
package/dist/docs-site/configuration.html +0 -464
package/dist/docs-site/favicon.svg +0 -14
package/dist/docs-site/followup.html +0 -375
package/dist/docs-site/gemini.html +0 -388
package/dist/docs-site/grok.html +0 -325
package/dist/docs-site/index.html +0 -360
package/dist/docs-site/install.html +0 -335
package/dist/docs-site/linux.html +0 -321
package/dist/docs-site/llms.txt +0 -44
package/dist/docs-site/manual-tests.html +0 -621
package/dist/docs-site/mcp.html +0 -412
package/dist/docs-site/multimodel.html +0 -364
package/dist/docs-site/mythical-pro-agents.html +0 -360
package/dist/docs-site/notifier.html +0 -338
package/dist/docs-site/openai-endpoints.html +0 -417
package/dist/docs-site/openrouter.html +0 -344
package/dist/docs-site/quickstart.html +0 -369
package/dist/docs-site/refactor/ux.html +0 -321
package/dist/docs-site/sessions.html +0 -397
package/dist/docs-site/social-card.png +0 -0
package/dist/docs-site/social-card.svg +0 -79
package/dist/docs-site/spec.html +0 -363
package/dist/docs-site/testing.html +0 -323
package/dist/docs-site/tui-debug.html +0 -326
package/dist/docs-site/windows-work.html +0 -348
package/dist/docs-site/windows.html +0 -320

package/dist/docs-site/agents.html DELETED Viewed

@@ -1,375 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Coding Agents — oracle</title>
-  <meta name="description" content="Use Oracle from Claude Code, Codex, Cursor, and any other coding agent — as a CLI, as an MCP server, or as a one-shot skill.">
-  <link rel="canonical" href="https://askoracle.sh/agents.html">
-  <meta property="og:type" content="website">
-  <meta property="og:site_name" content="oracle">
-  <meta property="og:title" content="Coding Agents — oracle">
-  <meta property="og:description" content="Use Oracle from Claude Code, Codex, Cursor, and any other coding agent — as a CLI, as an MCP server, or as a one-shot skill.">
-  <meta property="og:url" content="https://askoracle.sh/agents.html">
-  <meta property="og:image" content="https://askoracle.sh/social-card.png">
-  <meta property="og:image:width" content="1200">
-  <meta property="og:image:height" content="630">
-  <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="Coding Agents — oracle">
-  <meta name="twitter:description" content="Use Oracle from Claude Code, Codex, Cursor, and any other coding agent — as a CLI, as an MCP server, or as a one-shot skill.">
-  <meta name="twitter:image" content="https://askoracle.sh/social-card.png">
-  <link rel="icon" href="favicon.svg" type="image/svg+xml">
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <script>(function(){var s;try{s=localStorage.getItem('theme')}catch(e){}var d=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.dataset.theme=s||(d?'dark':'light')})();</script>
-  <style>
-:root{
-  --ink:#0e0a1f;
-  --text:#1d1832;
-  --muted:#6b6582;
-  --subtle:#9c95b5;
-  --bg:#fafaff;
-  --paper:#ffffff;
-  --accent:#7c3aed;
-  --accent-soft:rgba(124,58,237,.10);
-  --accent-strong:#5b21b6;
-  --accent-2:#0ea5e9;
-  --accent-glow:#a78bfa;
-  --line:#e7e3f0;
-  --line-soft:#f2eff8;
-  --code-bg:#0c0a1a;
-  --code-fg:#e9e6f5;
-  --code-inline-fg:#1c1734;
-  --pill-border:#dcd5ec;
-  --shadow-card:0 4px 14px rgba(14,10,31,.08);
-  --scrollbar:#cbc4dc;
-}
-:root[data-theme="dark"]{
-  --ink:#f5f2ff;
-  --text:#cec7e4;
-  --muted:#9189a8;
-  --subtle:#6a6383;
-  --bg:#0a0815;
-  --paper:#15102a;
-  --accent:#a78bfa;
-  --accent-soft:rgba(167,139,250,.18);
-  --accent-strong:#c4b5fd;
-  --accent-2:#38bdf8;
-  --accent-glow:#c4b5fd;
-  --line:#272140;
-  --line-soft:#1c1734;
-  --code-bg:#06040d;
-  --code-fg:#e9e6f5;
-  --code-inline-fg:#e9e6f5;
-  --pill-border:#2c2549;
-  --shadow-card:0 4px 18px rgba(0,0,0,.45);
-  --scrollbar:#3a3358;
-}
-:root{color-scheme:light}
-:root[data-theme="dark"]{color-scheme:dark}
-*{box-sizing:border-box}
-html{scroll-behavior:smooth;scroll-padding-top:24px}
-body{margin:0;background:var(--bg);color:var(--text);font-family:"Inter",ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;line-height:1.65;overflow-x:hidden;-webkit-font-smoothing:antialiased;font-feature-settings:"cv02","cv03","cv04","cv11";transition:background-color .18s,color .18s}
-::selection{background:var(--accent);color:#fff}
-a{color:var(--accent);text-decoration:none;transition:color .12s}
-a:hover{text-decoration:underline;text-underline-offset:.2em}
-.shell{display:grid;grid-template-columns:268px minmax(0,1fr);min-height:100vh}
-.sidebar{position:sticky;top:0;height:100vh;overflow:auto;padding:24px 22px;background:var(--paper);border-right:1px solid var(--line);scrollbar-width:thin;scrollbar-color:var(--line) transparent;transition:background-color .18s,border-color .18s}
-.sidebar::-webkit-scrollbar{width:6px}
-.sidebar::-webkit-scrollbar-thumb{background:var(--line);border-radius:6px}
-.sidebar-head{display:flex;align-items:center;gap:10px;margin-bottom:24px}
-.brand{display:flex;align-items:center;gap:11px;color:var(--ink);text-decoration:none;flex:1;min-width:0}
-.brand:hover{text-decoration:none}
-.brand .mark{flex:0 0 30px;width:30px;height:30px;border-radius:50%;background:radial-gradient(circle at 32% 32%,#fff 0,#e0d4ff 22%,#7c3aed 60%,#1e1240 100%);box-shadow:0 0 0 1px rgba(124,58,237,.35),0 6px 18px rgba(124,58,237,.35);position:relative}
-.brand .mark::after{content:"";position:absolute;left:50%;top:50%;width:9px;height:9px;border-radius:50%;background:#0c0820;transform:translate(-50%,-50%)}
-.brand strong{display:block;font-size:1.05rem;line-height:1.1;font-weight:600;letter-spacing:0;color:var(--ink)}
-.brand small{display:block;color:var(--muted);font-size:.74rem;margin-top:3px;font-weight:400}
-.theme-toggle{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;width:34px;height:34px;border-radius:8px;border:1px solid var(--line);background:var(--paper);color:var(--muted);cursor:pointer;padding:0;transition:border-color .15s,color .15s,background-color .15s,transform .12s}
-.theme-toggle:hover{border-color:var(--ink);color:var(--ink)}
-.theme-toggle:active{transform:scale(.94)}
-.theme-toggle svg{width:16px;height:16px;display:block}
-.theme-icon-sun{display:none}
-:root[data-theme="dark"] .theme-icon-sun{display:block}
-:root[data-theme="dark"] .theme-icon-moon{display:none}
-.search{display:block;margin:0 0 22px}
-.search span{display:block;color:var(--muted);font-size:.7rem;font-weight:600;text-transform:uppercase;letter-spacing:0;margin-bottom:7px}
-.search input{width:100%;border:1px solid var(--line);background:var(--paper);border-radius:8px;padding:9px 12px;font:inherit;font-size:.9rem;color:var(--text);outline:none;transition:border-color .15s,box-shadow .15s,background-color .18s}
-.search input:focus{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
-nav section{margin:0 0 18px}
-nav h2{font-size:.68rem;color:var(--muted);text-transform:uppercase;letter-spacing:0;margin:0 0 6px;font-weight:600}
-.nav-link{display:block;color:var(--text);text-decoration:none;border-radius:6px;padding:5px 10px;margin:1px 0;font-size:.9rem;line-height:1.4;transition:background .12s,color .12s}
-.nav-link:hover{background:var(--line-soft);color:var(--ink);text-decoration:none}
-.nav-link.active{background:var(--accent-soft);color:var(--accent);font-weight:600}
-main{min-width:0;padding:32px clamp(20px,4.5vw,56px) 80px;max-width:1180px;margin:0 auto;width:100%}
-.hero{display:flex;align-items:flex-end;justify-content:space-between;gap:22px;border-bottom:1px solid var(--line);padding:8px 0 22px;margin-bottom:8px;flex-wrap:wrap}
-.hero-text{min-width:0;flex:1 1 320px}
-.eyebrow{margin:0 0 8px;color:var(--muted);font-weight:600;text-transform:uppercase;letter-spacing:0;font-size:.7rem}
-.hero h1{font-size:2.25rem;line-height:1.1;letter-spacing:0;margin:0;font-weight:700;color:var(--ink)}
-.hero-meta{display:flex;gap:8px;flex:0 0 auto;flex-wrap:wrap}
-.repo,.edit,.btn-ghost{border:1px solid var(--line);color:var(--text);text-decoration:none;border-radius:7px;padding:6px 11px;font-weight:500;font-size:.83rem;background:var(--paper);transition:border-color .15s,color .15s,background .15s}
-.repo:hover,.edit:hover,.btn-ghost:hover{border-color:var(--ink);color:var(--ink);text-decoration:none}
-.edit{color:var(--muted)}
-.home-hero{position:relative;padding:24px 0 32px;margin-bottom:8px;border-bottom:1px solid var(--line)}
-.home-hero>*{position:relative;z-index:1}
-.home-hero h1{font-size:3.4rem;line-height:1.04;letter-spacing:0;margin:0 0 .35em;font-weight:700;color:var(--ink);background:linear-gradient(135deg,var(--ink) 0,#7c3aed 60%,#0ea5e9 100%);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
-:root[data-theme="dark"] .home-hero h1{background:linear-gradient(135deg,#f5f2ff 0,#c4b5fd 50%,#7dd3fc 100%);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:transparent}
-.home-hero .lede{font-size:1.18rem;line-height:1.55;color:var(--text);margin:0 0 1.2em;max-width:62ch}
-.home-cta{display:flex;flex-wrap:wrap;gap:10px;align-items:center;margin:0 0 18px}
-.home-cta .btn{display:inline-flex;align-items:center;gap:7px;border-radius:8px;padding:10px 16px;font-weight:600;font-size:.92rem;text-decoration:none;transition:background .15s,border-color .15s,color .15s,transform .12s}
-.home-cta .btn-primary{background:linear-gradient(135deg,var(--accent),var(--accent-strong));color:#fff;border:1px solid var(--accent);box-shadow:0 4px 14px rgba(124,58,237,.35)}
-.home-cta .btn-primary:hover{background:var(--accent-strong);border-color:var(--accent-strong);text-decoration:none;transform:translateY(-1px)}
-.home-cta .btn-ghost{padding:10px 16px}
-.home-install{display:flex;align-items:center;gap:12px;background:var(--code-bg);color:var(--code-fg);border-radius:8px;padding:10px 10px 10px 16px;font:500 .9rem/1.2 "JetBrains Mono","SF Mono",ui-monospace,monospace;max-width:34em;border:1px solid #1f1840}
-.home-install .prompt{color:#6f63a3;user-select:none;flex:0 0 auto}
-.home-install code{flex:1;background:transparent;border:0;color:var(--code-fg);font:inherit;padding:0;white-space:pre;overflow:hidden;text-overflow:ellipsis}
-.home-install .copy{flex:0 0 auto;background:rgba(255,255,255,.08);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:6px;padding:5px 11px;font:500 .72rem/1 "Inter",sans-serif;cursor:pointer;transition:background .15s,border-color .15s}
-.home-install .copy:hover{background:rgba(255,255,255,.16)}
-.home-install .copy.copied{background:var(--accent);border-color:var(--accent)}
-.home-services{display:flex;flex-wrap:wrap;gap:6px;margin:6px 0 18px}
-.home-services span{display:inline-block;padding:3px 10px;border:1px solid var(--pill-border);border-radius:999px;font-size:.78rem;color:var(--muted);background:var(--paper)}
-.home-services span.pill-pro{background:var(--accent-soft);color:var(--accent);border-color:transparent;font-weight:600}
-.home-visual{display:block;width:min(100%,620px);height:auto;margin:22px 0 0;border-radius:8px;border:1px solid var(--line);box-shadow:var(--shadow-card);background:var(--paper)}
-.doc-grid{display:grid;grid-template-columns:minmax(0,1fr);gap:48px;margin-top:24px}
-.doc-grid-home{margin-top:8px}
-@media(min-width:1180px){.doc-grid{grid-template-columns:minmax(0,72ch) 200px;justify-content:start}.doc-grid-home{grid-template-columns:minmax(0,76ch);justify-content:start}}
-.doc{min-width:0;max-width:72ch;overflow-wrap:break-word}
-.doc-home{max-width:76ch}
-.doc h1{font-size:2.6rem;line-height:1.08;letter-spacing:0;margin:0 0 .4em;font-weight:700;color:var(--ink)}
-body:not(.home) .doc>h1:first-child{display:none}
-.doc h2{font-size:1.45rem;line-height:1.2;margin:2em 0 .5em;font-weight:600;letter-spacing:0;color:var(--ink);position:relative}
-.doc h3{font-size:1.1rem;margin:1.7em 0 .35em;position:relative;font-weight:600;color:var(--ink);letter-spacing:0}
-.doc h4{font-size:.98rem;margin:1.4em 0 .25em;color:var(--ink);position:relative;font-weight:600}
-.doc h2:first-child,.doc h3:first-child,.doc h4:first-child{margin-top:.2em}
-.doc :is(h2,h3,h4) .anchor{position:absolute;left:-1.05em;top:0;color:var(--subtle);opacity:0;text-decoration:none;font-weight:400;padding-right:.3em;transition:opacity .12s,color .12s}
-.doc :is(h2,h3,h4):hover .anchor{opacity:.7}
-.doc :is(h2,h3,h4) .anchor:hover{opacity:1;color:var(--accent);text-decoration:none}
-.doc p{margin:0 0 1.05em}
-.doc ul,.doc ol{padding-left:1.3rem;margin:0 0 1.15em}
-.doc li{margin:.25em 0}
-.doc li>p{margin:0 0 .4em}
-.doc strong{font-weight:600;color:var(--ink)}
-.doc em{font-style:italic}
-.doc code{font-family:"JetBrains Mono","SF Mono",ui-monospace,monospace;font-size:.84em;background:var(--line-soft);border:1px solid var(--line);border-radius:5px;padding:.08em .35em;color:var(--code-inline-fg)}
-.doc pre{position:relative;overflow:auto;background:var(--code-bg);color:var(--code-fg);border-radius:8px;padding:14px 18px;margin:1.3em 0;font-size:.85em;line-height:1.6;scrollbar-width:thin;scrollbar-color:#3a3358 transparent;border:1px solid #221c40}
-.doc pre.shiki{background:var(--code-bg)!important;color:var(--code-fg)!important}
-.doc pre::-webkit-scrollbar{height:8px;width:8px}
-.doc pre::-webkit-scrollbar-thumb{background:#3a3358;border-radius:8px}
-.doc pre code{display:block;background:transparent;border:0;color:inherit;padding:0;font-size:1em;white-space:pre}
-.doc pre code .line{display:block;min-height:1.6em}
-.doc pre .copy{position:absolute;top:8px;right:8px;background:rgba(255,255,255,.06);color:var(--code-fg);border:1px solid rgba(255,255,255,.16);border-radius:6px;padding:3px 9px;font:500 .7rem/1 "Inter",sans-serif;cursor:pointer;opacity:0;transition:opacity .15s,background .15s,border-color .15s}
-.doc pre:hover .copy,.doc pre .copy:focus{opacity:1}
-.doc pre .copy:hover{background:rgba(255,255,255,.12)}
-.doc pre .copy.copied{background:var(--accent);border-color:var(--accent);opacity:1}
-.doc blockquote{margin:1.4em 0;padding:10px 16px;border-left:3px solid var(--accent);background:var(--accent-soft);border-radius:0 8px 8px 0;color:var(--text)}
-.doc blockquote p:last-child{margin-bottom:0}
-.doc table{width:100%;border-collapse:collapse;margin:1.2em 0;font-size:.92em}
-.doc th,.doc td{border-bottom:1px solid var(--line);padding:9px 10px;text-align:left;vertical-align:top}
-.doc th{font-weight:600;color:var(--ink);background:var(--line-soft);border-bottom:1px solid var(--line)}
-.doc hr{border:0;border-top:1px solid var(--line);margin:2.2em 0}
-.toc{position:sticky;top:24px;align-self:start;font-size:.84rem;padding-left:14px;border-left:1px solid var(--line);max-height:calc(100vh - 48px);overflow:auto;scrollbar-width:thin;scrollbar-color:var(--line) transparent}
-.toc::-webkit-scrollbar{width:5px}
-.toc::-webkit-scrollbar-thumb{background:var(--line);border-radius:5px}
-.toc h2{font-size:.66rem;color:var(--muted);text-transform:uppercase;letter-spacing:0;margin:0 0 10px;font-weight:600}
-.toc a{display:block;color:var(--muted);text-decoration:none;padding:4px 0 4px 10px;line-height:1.35;border-left:2px solid transparent;margin-left:-12px;transition:color .12s,border-color .12s}
-.toc a:hover{color:var(--ink);text-decoration:none}
-.toc a.active{color:var(--accent);border-left-color:var(--accent);font-weight:500}
-.toc-l3{padding-left:22px!important;font-size:.94em}
-@media(max-width:1179px){.toc{display:none}}
-.page-nav{display:grid;grid-template-columns:1fr 1fr;gap:14px;margin-top:48px;border-top:1px solid var(--line);padding-top:20px}
-.page-nav>a{display:block;border:1px solid var(--line);background:var(--paper);border-radius:9px;padding:13px 16px;text-decoration:none;color:var(--text);transition:border-color .15s,transform .15s,box-shadow .15s,background-color .18s}
-.page-nav>a:hover{border-color:var(--accent);text-decoration:none;color:var(--ink)}
-.page-nav small{display:block;color:var(--muted);font-size:.7rem;text-transform:uppercase;letter-spacing:0;margin-bottom:5px;font-weight:600}
-.page-nav span{display:block;font-weight:600;line-height:1.3;color:var(--ink)}
-.page-nav-prev{text-align:left}
-.page-nav-next{text-align:right;grid-column:2}
-.page-nav-prev:only-child{grid-column:1}
-.nav-toggle{display:none;position:fixed;top:14px;right:14px;top:calc(14px + env(safe-area-inset-top, 0px));right:calc(14px + env(safe-area-inset-right, 0px));z-index:20;width:40px;height:40px;border-radius:9px;background:var(--paper);border:1px solid var(--line);color:var(--ink);cursor:pointer;padding:10px 9px;flex-direction:column;align-items:stretch;justify-content:space-between;box-shadow:var(--shadow-card)}
-.nav-toggle span{display:block;width:100%;height:2px;flex:0 0 2px;background:currentColor;border-radius:2px;transition:transform .2s,opacity .2s}
-.nav-toggle[aria-expanded="true"] span:nth-child(1){transform:translateY(8px) rotate(45deg)}
-.nav-toggle[aria-expanded="true"] span:nth-child(2){opacity:0}
-.nav-toggle[aria-expanded="true"] span:nth-child(3){transform:translateY(-8px) rotate(-45deg)}
-@media(max-width:900px){
-  .shell{display:block}
-  .sidebar{position:fixed;inset:0 30% 0 0;max-width:320px;height:100vh;z-index:15;transform:translateX(-100%);transition:transform .25s ease,background-color .18s,border-color .18s;box-shadow:0 18px 40px rgba(0,0,0,.18);background:var(--paper);pointer-events:none}
-  .sidebar.open{transform:translateX(0);pointer-events:auto}
-  .nav-toggle{display:flex}
-  main{padding:64px 18px 56px}
-  .hero{padding-top:6px}
-  .hero h1{font-size:1.8rem}
-  .home-hero h1{font-size:2.45rem}
-  .doc h1{font-size:2.1rem}
-  .hero-meta{width:100%;justify-content:flex-start}
-  .home-hero{padding-top:8px}
-  .home-visual{margin-top:18px}
-  .doc{padding:0}
-  .doc-grid{margin-top:18px;gap:24px}
-  .doc :is(h2,h3,h4) .anchor{display:none}
-}
-@media(max-width:520px){
-  main{padding:60px 14px 48px}
-  .doc pre{margin-left:-14px;margin-right:-14px;border-radius:0;border-left:0;border-right:0}
-  .home-install{flex-wrap:wrap}
-}
-</style>
-</head>
-<body>
-  <button class="nav-toggle" type="button" aria-label="Toggle navigation" aria-expanded="false">
-    <span aria-hidden="true"></span><span aria-hidden="true"></span><span aria-hidden="true"></span>
-  </button>
-  <div class="shell">
-    <aside class="sidebar">
-      <div class="sidebar-head">
-        <a class="brand" href="./" aria-label="oracle docs home">
-          <span class="mark" aria-hidden="true"></span>
-          <span><strong>oracle</strong><small>askoracle.sh</small></span>
-        </a>
-        <button class="theme-toggle" type="button" aria-label="Toggle dark mode" aria-pressed="false" data-theme-toggle>
-    <svg class="theme-icon-moon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.6 12.1A6.5 6.5 0 0 1 7.4 2.7a6.5 6.5 0 1 0 7.2 9.4z" fill="currentColor"/></svg>
-    <svg class="theme-icon-sun" viewBox="0 0 20 20" aria-hidden="true"><circle cx="10" cy="10" r="3.4" fill="currentColor"/><g stroke="currentColor" stroke-width="1.6" stroke-linecap="round"><line x1="10" y1="2" x2="10" y2="4"/><line x1="10" y1="16" x2="10" y2="18"/><line x1="2" y1="10" x2="4" y2="10"/><line x1="16" y1="10" x2="18" y2="10"/><line x1="4.2" y1="4.2" x2="5.6" y2="5.6"/><line x1="14.4" y1="14.4" x2="15.8" y2="15.8"/><line x1="4.2" y1="15.8" x2="5.6" y2="14.4"/><line x1="14.4" y1="5.6" x2="15.8" y2="4.2"/></g></svg>
-  </button>
-      </div>
-      <label class="search"><span>Search</span><input id="doc-search" type="search" placeholder="browser, mcp, sessions"></label>
-      <nav><section><h2>Start</h2><a class="nav-link" href="./">Overview</a><a class="nav-link" href="install.html">Install</a><a class="nav-link" href="quickstart.html">Quickstart</a><a class="nav-link" href="configuration.html">Local configuration (JSON5)</a></section><section><h2>Mythical Pro Agents</h2><a class="nav-link" href="mythical-pro-agents.html">Mythical Pro Agents</a><a class="nav-link" href="openai-endpoints.html">OpenAI-Compatible Endpoints</a><a class="nav-link" href="anthropic.html">Anthropic (Claude) Integration Plan</a><a class="nav-link" href="gemini.html">Gemini Integration</a><a class="nav-link" href="openrouter.html">OpenRouter</a><a class="nav-link" href="grok.html">Grok 4.1 (xAI) Support</a></section><section><h2>Browser Mode</h2><a class="nav-link" href="browser-mode.html">Browser Mode</a><a class="nav-link" href="chromium-forks.html">Chromium-based browsers (Chromium, Edge, Brave variants)</a><a class="nav-link" href="linux.html">Linux Notes</a><a class="nav-link" href="windows.html">Windows compatibility notes</a><a class="nav-link" href="windows-work.html">Windows Work</a><a class="nav-link" href="bridge.html">Bridge (Windows-hosted ChatGPT session → Linux clients)</a></section><section><h2>Agents &amp; MCP</h2><a class="nav-link active" href="agents.html">Coding Agents</a><a class="nav-link" href="mcp.html">MCP Server</a></section><section><h2>Workflows</h2><a class="nav-link" href="sessions.html">Sessions</a><a class="nav-link" href="followup.html">Followups &amp; Lineage</a><a class="nav-link" href="multimodel.html">Multi-Model Execution</a></section><section><h2>Reference</h2><a class="nav-link" href="cli-reference.html">CLI Reference</a><a class="nav-link" href="spec.html">Spec</a><a class="nav-link" href="notifier.html">Session completion notifications</a><a class="nav-link" href="tui-debug.html">TUI navigation crash notes (2025-11-19)</a><a class="nav-link" href="manual-tests.html">Manual Test Suite (Browser Mode + Live API)</a><a class="nav-link" href="testing.html">Testing quickstart</a><a class="nav-link" href="RELEASING.html">Release Checklist (npm + Homebrew)</a></section></nav>
-    </aside>
-    <main>
-      <header class="hero">
-        <div class="hero-text">
-          <p class="eyebrow">Agents &amp; MCP</p>
-          <h1>Coding Agents</h1>
-        </div>
-        <div class="hero-meta">
-          <a class="repo" href="https://github.com/steipete/oracle" rel="noopener">GitHub</a>
-          <a class="edit" href="https://github.com/steipete/oracle/edit/main/docs/agents.md" rel="noopener">Edit page</a>
-        </div>
-      </header>
-      <div class="doc-grid">
-        <article class="doc"><p>Oracle is built to be called <em>by</em> coding agents as much as by humans. The flow is always the same: the agent gathers context, hands the bundle to a stronger Pro model, gets a second opinion back.</p>
-<h2 id="the-30-second-wiring"><a class="anchor" href="#the-30-second-wiring" aria-label="Anchor link">#</a>The 30-second wiring</h2>
-<p>Drop this into the project&#39;s <code>AGENTS.md</code> or <code>CLAUDE.md</code>:</p>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-text"><span class="line"><span>- Oracle bundles a prompt plus the right files so a Pro model (GPT-5.5 Pro,</span></span>
-<span class="line"><span>  Gemini 3 Pro, Claude Opus) can answer with real repo context. Use when stuck,</span></span>
-<span class="line"><span>  debugging hard bugs, doing architecture review, or cross-validating a plan.</span></span>
-<span class="line"><span>- Run `npx -y @steipete/oracle --help` once per session before first use.</span></span></code></pre>
-<p>That&#39;s enough for most agents to discover and use Oracle correctly. The patterns below cover the deeper integrations.</p>
-<p>For explicit API/browser/render selection and per-run model/effort provenance, use the optional <code>skills/oracle-advisor</code> companion skill instead. It reuses the existing backends and does not implement native desktop delegation. See <a href="advisor.html">Advisory consultations</a> for its capability boundary and result contract. The existing <code>skills/oracle</code> workflow remains available unchanged.</p>
-<h2 id="claude-code"><a class="anchor" href="#claude-code" aria-label="Anchor link">#</a>Claude Code</h2>
-<h3 id="as-an-mcp-server-recommended"><a class="anchor" href="#as-an-mcp-server-recommended" aria-label="Anchor link">#</a>As an MCP server (recommended)</h3>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-bash"><span class="line"><span style="color:#F69D50">oracle</span><span style="color:#96D0FF"> bridge</span><span style="color:#96D0FF"> claude-config</span><span style="color:#6CB6FF"> --local-browser</span><span style="color:#F47067"> ></span><span style="color:#96D0FF"> .mcp.json</span></span></code></pre>
-<p>That writes a <code>.mcp.json</code> configured for the local browser path, so Claude Code can call <code>oracle.consult</code> and <code>oracle.sessions</code> without any API keys. Use the MCP <code>consult</code> tool with <code>preset: &quot;chatgpt-pro-heavy&quot;</code> for ChatGPT GPT-5.5 Pro with Pro Extended thinking. Add <code>dryRun: true</code> to inspect the resolved bundle before sending.</p>
-<p>See <a href="mcp.html">MCP</a> for connection details and other clients.</p>
-<h3 id="as-a-skill"><a class="anchor" href="#as-a-skill" aria-label="Anchor link">#</a>As a skill</h3>
-<p>Copy the bundled skill into <code>~/.claude/skills/</code>:</p>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-bash"><span class="line"><span style="color:#F69D50">mkdir</span><span style="color:#6CB6FF"> -p</span><span style="color:#96D0FF"> ~/.claude/skills</span></span>
-<span class="line"><span style="color:#F69D50">cp</span><span style="color:#6CB6FF"> -R</span><span style="color:#96D0FF"> skills/oracle</span><span style="color:#96D0FF"> ~/.claude/skills/oracle</span></span></code></pre>
-<p>Then reference <code>oracle</code> in <code>CLAUDE.md</code>. Claude Code will load <code>SKILL.md</code> whenever the trigger conditions match (debugging, refactor, design check).</p>
-<h3 id="as-a-slash-command"><a class="anchor" href="#as-a-slash-command" aria-label="Anchor link">#</a>As a slash command</h3>
-<p>Many users alias Oracle behind a custom <code>/consult</code> slash command that wraps <code>npx -y @steipete/oracle --engine browser …</code>. Pair with <code>--browser-tab current</code> to keep all consults in one ChatGPT conversation.</p>
-<h2 id="codex"><a class="anchor" href="#codex" aria-label="Anchor link">#</a>Codex</h2>
-<p>Copy the same skill into the Codex skills folder:</p>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-bash"><span class="line"><span style="color:#F69D50">mkdir</span><span style="color:#6CB6FF"> -p</span><span style="color:#96D0FF"> ~/.codex/skills</span></span>
-<span class="line"><span style="color:#F69D50">cp</span><span style="color:#6CB6FF"> -R</span><span style="color:#96D0FF"> skills/oracle</span><span style="color:#96D0FF"> ~/.codex/skills/oracle</span></span></code></pre>
-<p>Then reference it in <code>AGENTS.md</code>. Codex will pick it up automatically.</p>
-<p>For Codex slash prompts, drop a wrapper in <code>~/.codex/prompts/oracle.md</code> that calls Oracle with your preferred defaults (engine, model, follow-up flags).</p>
-<h2 id="cursor"><a class="anchor" href="#cursor" aria-label="Anchor link">#</a>Cursor</h2>
-<p>Cursor speaks MCP. Drop a <code>.cursor/mcp.json</code> like:</p>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-json"><span class="line"><span style="color:#ADBAC7">{</span></span>
-<span class="line"><span style="color:#8DDB8C">  "oracle"</span><span style="color:#ADBAC7">: {</span></span>
-<span class="line"><span style="color:#8DDB8C">    "command"</span><span style="color:#ADBAC7">: </span><span style="color:#96D0FF">"oracle-mcp"</span><span style="color:#ADBAC7">,</span></span>
-<span class="line"><span style="color:#8DDB8C">    "args"</span><span style="color:#ADBAC7">: []</span></span>
-<span class="line"><span style="color:#ADBAC7">  }</span></span>
-<span class="line"><span style="color:#ADBAC7">}</span></span></code></pre>
-<p>Or use the <a href="https://cursor.com/en-US/install-mcp?name=oracle&amp;amp;config=eyJjb21tYW5kIjoibnB4IC15IEBzdGVpcGV0ZS9vcmFjbGUgb3JhY2xlLW1jcCJ9">one-click install</a>. The <code>oracle</code> source then shows up in Cursor&#39;s MCP picker.</p>
-<h2 id="generic-cli-usage-from-any-agent"><a class="anchor" href="#generic-cli-usage-from-any-agent" aria-label="Anchor link">#</a>Generic CLI usage from any agent</h2>
-<p>When the agent has shell access, the simplest hand-off is the bundle-on-clipboard fallback:</p>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-bash"><span class="line"><span style="color:#F69D50">oracle</span><span style="color:#6CB6FF"> --render</span><span style="color:#6CB6FF"> --copy</span><span style="color:#6CB6FF"> -p</span><span style="color:#96D0FF"> "</span><span style="color:#ADBAC7">$TASK</span><span style="color:#96D0FF">"</span><span style="color:#6CB6FF"> --file</span><span style="color:#96D0FF"> "</span><span style="color:#ADBAC7">$RELEVANT_FILES</span><span style="color:#96D0FF">"</span></span></code></pre>
-<p>…then the agent (or a human) pastes into whichever Pro model they have access to. No keys, no MCP, works everywhere.</p>
-<p>For autonomous dry-runs, use the JSON preview to inspect the resolved bundle before spending model time:</p>
-<pre class="shiki github-dark-dimmed" style="background-color:var(--code-bg);color:var(--code-fg)" tabindex="0"><code class="language-bash"><span class="line"><span style="color:#F69D50">oracle</span><span style="color:#6CB6FF"> --dry-run</span><span style="color:#96D0FF"> json</span><span style="color:#6CB6FF"> --model</span><span style="color:#96D0FF"> gpt-5.5-pro</span><span style="color:#6CB6FF"> -p</span><span style="color:#96D0FF"> "</span><span style="color:#ADBAC7">$TASK</span><span style="color:#96D0FF">"</span><span style="color:#6CB6FF"> --file</span><span style="color:#96D0FF"> "</span><span style="color:#ADBAC7">$RELEVANT_FILES</span><span style="color:#96D0FF">"</span></span></code></pre>
-<p>Completed runs persist answers, usage, cost, session ids, model choices, and lineage under <code>~/.oracle/sessions/&lt;id&gt;/</code>. Exit code is non-zero on failure.</p>
-<h2 id="multi-agent-shared-profile-browser-mode"><a class="anchor" href="#multi-agent-shared-profile-browser-mode" aria-label="Anchor link">#</a>Multi-agent shared profile (browser mode)</h2>
-<p>When multiple agents share one signed-in Chrome profile (the manual-login workflow), Oracle coordinates browser tab slots so parallel runs queue instead of crashing. Tune with:</p>
-<ul>
-<li><code>--browser-max-concurrent-tabs</code> — default 3 simultaneous tabs.</li>
-<li><code>--browser-profile-lock-timeout</code> — wait for the profile lock before sending.</li>
-<li><code>--browser-reuse-wait</code> — wait for a shared Chrome profile before launching.</li>
-</ul>
-<p>For the most reliable shared setup: run one signed-in Chrome with remote debugging, point all callers at it via <code>--remote-chrome &lt;host:port&gt;</code>. See <a href="browser-mode.html">Browser Mode</a>.</p>
-<h2 id="cost-safety-hygiene"><a class="anchor" href="#cost-safety-hygiene" aria-label="Anchor link">#</a>Cost / safety hygiene</h2>
-<ul>
-<li><strong>Always preview Pro runs.</strong> <code>--dry-run summary --files-report</code> before a Pro API call on a large bundle. Token counts are a close-enough proxy for dollars.</li>
-<li><strong>Cap file size.</strong> <code>~/.oracle/config.json</code> → <code>maxFileSizeBytes</code>, or <code>ORACLE_MAX_FILE_SIZE_BYTES</code>. Default is 1 MB per file.</li>
-<li><strong>Excludes are your friend.</strong> <code>--file &quot;src/**&quot; --file &quot;!**/*.test.ts&quot; --file &quot;!**/*.snap&quot;</code> cuts most fixtures.</li>
-<li><strong>API mode runs cost real money.</strong> If your agent runs Oracle autonomously, scope it: pin <code>--model</code>, set <code>--timeout</code>, and review the session log. Many users gate API mode behind explicit user consent and let browser mode run free.</li>
-</ul>
-<h2 id="patterns-that-work"><a class="anchor" href="#patterns-that-work" aria-label="Anchor link">#</a>Patterns that work</h2>
-<ul>
-<li><strong>Stuck → Oracle.</strong> When the agent has been spinning on the same bug for 3+ turns, hand the failing test plus the involved files to GPT-5.5 Pro. It often spots the issue in one round.</li>
-<li><strong>Plan → Oracle → execute.</strong> Draft the plan, ask Claude Opus or Gemini 3 Pro to challenge it, then implement.</li>
-<li><strong>Refactor → cross-check.</strong> After a non-trivial refactor, send the diff plus the spec to a different provider than the one that wrote the diff. Catches drift fast.</li>
-<li><strong>Followup chain.</strong> Use <code>--followup &lt;id&gt;</code> to keep one Pro session alive across iterations rather than re-bundling the whole repo every time. See <a href="followup.html">Followup</a>.</li>
-</ul><nav class="page-nav" aria-label="Pager"><a class="page-nav-prev" href="bridge.html"><small>Previous</small><span>Bridge (Windows-hosted ChatGPT session → Linux clients)</span></a><a class="page-nav-next" href="mcp.html"><small>Next</small><span>MCP Server</span></a></nav></article>
-        <nav class="toc" aria-label="On this page"><h2>On this page</h2><a class="toc-l2" href="#the-30-second-wiring">The 30-second wiring</a><a class="toc-l2" href="#claude-code">Claude Code</a><a class="toc-l3" href="#as-an-mcp-server-recommended">As an MCP server (recommended)</a><a class="toc-l3" href="#as-a-skill">As a skill</a><a class="toc-l3" href="#as-a-slash-command">As a slash command</a><a class="toc-l2" href="#codex">Codex</a><a class="toc-l2" href="#cursor">Cursor</a><a class="toc-l2" href="#generic-cli-usage-from-any-agent">Generic CLI usage from any agent</a><a class="toc-l2" href="#multi-agent-shared-profile-browser-mode">Multi-agent shared profile (browser mode)</a><a class="toc-l2" href="#cost-safety-hygiene">Cost / safety hygiene</a><a class="toc-l2" href="#patterns-that-work">Patterns that work</a></nav>
-      </div>
-    </main>
-  </div>
-  <script>
-const themeRoot=document.documentElement;
-function applyTheme(mode){themeRoot.dataset.theme=mode;document.querySelectorAll('[data-theme-toggle]').forEach(b=>b.setAttribute('aria-pressed',mode==='dark'?'true':'false'))}
-function storedTheme(){try{return localStorage.getItem('theme')}catch(e){return null}}
-function persistTheme(mode){try{localStorage.setItem('theme',mode)}catch(e){}}
-applyTheme(themeRoot.dataset.theme==='dark'?'dark':'light');
-document.querySelectorAll('[data-theme-toggle]').forEach(btn=>{btn.addEventListener('click',()=>{const next=themeRoot.dataset.theme==='dark'?'light':'dark';applyTheme(next);persistTheme(next)})});
-const systemDark=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)');
-function onSystemChange(e){if(storedTheme())return;applyTheme(e.matches?'dark':'light')}
-if(systemDark){if(systemDark.addEventListener)systemDark.addEventListener('change',onSystemChange);else if(systemDark.addListener)systemDark.addListener(onSystemChange)}
-const sidebar=document.querySelector('.sidebar');
-const toggle=document.querySelector('.nav-toggle');
-const mobileNav=window.matchMedia('(max-width: 900px)');
-const sidebarFocusable='a[href],button,input,select,textarea,[tabindex]';
-function setSidebarFocusable(enabled){
-  sidebar?.querySelectorAll(sidebarFocusable).forEach((el)=>{
-    if(enabled){
-      if(el.dataset.sidebarTabindex!==undefined){
-        if(el.dataset.sidebarTabindex)el.setAttribute('tabindex',el.dataset.sidebarTabindex);
-        else el.removeAttribute('tabindex');
-        delete el.dataset.sidebarTabindex;
-      }
-    }else if(el.dataset.sidebarTabindex===undefined){
-      el.dataset.sidebarTabindex=el.getAttribute('tabindex')??'';
-      el.setAttribute('tabindex','-1');
-    }
-  });
-}
-function setSidebarOpen(open){
-  if(!sidebar||!toggle)return;
-  sidebar.classList.toggle('open',open);
-  toggle.setAttribute('aria-expanded',open?'true':'false');
-  if(mobileNav.matches){
-    sidebar.inert=!open;
-    if(open)sidebar.removeAttribute('aria-hidden');
-    else sidebar.setAttribute('aria-hidden','true');
-    setSidebarFocusable(open);
-  }else{
-    sidebar.inert=false;
-    sidebar.removeAttribute('aria-hidden');
-    setSidebarFocusable(true);
-  }
-}
-setSidebarOpen(false);
-toggle?.addEventListener('click',()=>setSidebarOpen(!sidebar?.classList.contains('open')));
-document.addEventListener('click',(e)=>{if(!sidebar?.classList.contains('open'))return;if(sidebar.contains(e.target)||toggle?.contains(e.target))return;setSidebarOpen(false)});
-document.addEventListener('keydown',(e)=>{if(e.key==='Escape')setSidebarOpen(false)});
-const syncSidebarForViewport=()=>setSidebarOpen(sidebar?.classList.contains('open')??false);
-if(mobileNav.addEventListener)mobileNav.addEventListener('change',syncSidebarForViewport);
-else mobileNav.addListener?.(syncSidebarForViewport);
-const input=document.getElementById('doc-search');
-input?.addEventListener('input',()=>{const q=input.value.trim().toLowerCase();document.querySelectorAll('nav section').forEach(sec=>{let any=false;sec.querySelectorAll('.nav-link').forEach(a=>{const m=!q||a.textContent.toLowerCase().includes(q);a.style.display=m?'block':'none';if(m)any=true});sec.style.display=any?'block':'none'})});
-function attachCopy(target,getText){const btn=document.createElement('button');btn.type='button';btn.className='copy';btn.textContent='Copy';btn.addEventListener('click',async()=>{try{await navigator.clipboard.writeText(getText());btn.textContent='Copied';btn.classList.add('copied');setTimeout(()=>{btn.textContent='Copy';btn.classList.remove('copied')},1400)}catch{btn.textContent='Failed';setTimeout(()=>{btn.textContent='Copy'},1400)}});target.appendChild(btn)}
-document.querySelectorAll('.doc pre').forEach(pre=>attachCopy(pre,()=>pre.querySelector('code')?.textContent??''));
-document.querySelectorAll('.home-install').forEach(el=>attachCopy(el,()=>el.querySelector('code')?.textContent??''));
-const tocLinks=document.querySelectorAll('.toc a');
-if(tocLinks.length){const map=new Map();tocLinks.forEach(a=>{const id=a.getAttribute('href').slice(1);const el=document.getElementById(id);if(el)map.set(el,a)});const setActive=l=>{tocLinks.forEach(x=>x.classList.remove('active'));l.classList.add('active')};const obs=new IntersectionObserver(entries=>{const visible=entries.filter(e=>e.isIntersecting).sort((a,b)=>a.boundingClientRect.top-b.boundingClientRect.top);if(visible.length){const link=map.get(visible[0].target);if(link)setActive(link)}},{rootMargin:'-15% 0px -65% 0px',threshold:0});map.forEach((_,el)=>obs.observe(el))}
-</script>
-</body>
-</html>