Companion for Oh My Pi and pi · community project

Send the hard question to ChatGPT or Grok. Keep working.

Keep using Oh My Pi or pi in your terminal. /oracle packs a context-rich archive of the repository, hands it with your prompt to ChatGPT or Grok in an isolated browser session, and returns immediately. The answer is saved to disk, and the session that asked gets one wake-up when it lands. Your own subscription, not an API key.

Install. pi-oracle on npm is the upstream package and does not carry this fork's changes; remove it first if you have it.

omp install omp-oracle        # Oh My Pi
pi install npm:omp-oracle     # pi

Get started Read the architecture

What a run looks like

The agent preflights local session and auth readiness before reading anything expensive.
It gathers a context-rich slice of the repository and oracle_submit builds a provider archive (.tar.zst for ChatGPT, .tar.gz for Grok, capped at 250 MiB and 200 MiB).
A detached worker clones an isolated, authenticated browser profile (or pins one tab in your signed-in Chrome through the opt-in relay) and uploads archive and prompt.
The response and any artifacts are saved under /tmp/oracle-<job-id>/.
The session that asked gets one best-effort wake-up; /oracle-read <job-id> works either way.

Use it when

You review broad repository changes before shipping and want a slower, larger second opinion that does not block the main agent turn.
You have a real ChatGPT or Grok subscription and want to use it from the agent instead of paying for API tokens.
Migration, architecture, or failure-mode analysis benefits from a large archive of the real code, and you may want to continue the same provider thread later.

Use something else when

The task is a short local coding change the host agent can do directly.
The project must never be uploaded to ChatGPT.com, Grok, or another web provider.
You need a hosted, multi-user, or API-key-based route; this is a single-operator local tool.

What leaves your machine

Exactly two things per job, under your own account: the prompt and one project archive. Archive inputs must resolve inside the project without symlink escapes; .git, tool state, secrets/, .env*, keys, and databases are excluded by default. Your real browser profile is read for cookies once, read-only, and never automated by default. There is no telemetry and no hosted control plane. Full model: security · exact support and limits.

Status

Experimental public beta, forked from fitchmultz/pi-oracle with an existing-Chrome relay transport and Oh My Pi host compatibility added. pi 0.80.9 is the validated upstream baseline; Oh My Pi 18.2.6 is observed loading the extension (upstream 0.7.20 build) and resolving this checkout as omp-oracle. The live ChatGPT proof for every preset and the Ubuntu packaged-install lane passed through the fork's build on 2026-09-20; the exact entries live in the release ledger.

The OMP family

OMP NInfer — durable local inference
OMP Session Gateway — every live session, one private mobile page
OMP Oracle — this project