opencode-gpt-pro is a working fork of steipete/oracle aimed at one specific job: making GPT Pro in ChatGPT usable as a dependable backend for OpenCode.
The upstream Oracle codebase already has the hard parts of browser automation, file bundling, session storage, remote browser bridging, and MCP. This fork keeps that base and pushes it toward an OpenCode-first workflow where long-lived sessions, forwarded repo context, and browser-bound GPT Pro runs need to work together without constant manual recovery.
The immediate trigger was practical rather than theoretical.
- OpenCode's Oracle bridge forwarded a full
opencode-session-context.mdtranscript. - Oracle rejected that attachment once it crossed the local per-file size guard.
- The failure happened before ChatGPT or GPT Pro ever saw the request.
This fork exists to close that gap and then keep moving in the same direction: fewer brittle handoffs, better browser defaults, and a cleaner OpenCode integration story.
- The repo is positioned around OpenCode + GPT Pro, not a generic model router first.
- It carries OpenCode companion artifacts under
examples/opencode/. - The recommended local config raises Oracle's file attachment cap so OpenCode consults do not fail at 1 MB.
- The OpenCode bridge plugin included here bounds the forwarded session transcript before it is attached.
- The transcript compaction is deterministic. It trims and drops older context by budget. It does not call another model to summarize your session.
- The codebase is still derived from
steipete/oracle. - The package and binary names are still
@steipete/oracleandoracle. - Most of the CLI, browser, bridge, and MCP surface remains compatible with upstream.
- The active fork-specific work is concentrated on OpenCode integration, browser-first GPT Pro defaults, and context handoff reliability.
If you want the fork in the way it is intended to be used today:
git clone https://github.com/tokenbender/opencode-gpt-pro.git
cd opencode-gpt-pro
bun install
bun run opencode:syncbun run opencode:sync bundles the split OpenCode bridge source into a single deployed oracle-agent.js file inside ~/.config/opencode/plugins/.
Then merge the recommended settings from examples/opencode/oracle-config.json5 into ~/.oracle/config.json.
At minimum, this fork currently expects:
{
maxFileSizeBytes: 4194304,
browser: {
modelStrategy: "current",
},
}Restart OpenCode after copying the plugin.
docs/opencode.mdexplains the OpenCode integration, the current context-budgeting behavior, and the install path.docs/query-aware-memory.mdlays out the next memory architecture and the current Milestone 1 extraction layer.docs/roadmap.mdstates where the fork is headed and what is intentionally not changing yet.docs/configuration.mdremains the reference for Oracle config shape and now includes the recommended fork baseline.docs/bridge.mdcovers the remote-browser workflow when ChatGPT lives on another machine.examples/opencode/contains the fork-specific companion files that are not yet part of the published package surface.
The near-term direction is straightforward.
- Make OpenCode the primary integration target rather than an afterthought.
- Treat GPT Pro in ChatGPT as a first-class execution environment, not only a manual fallback.
- Productize the context handoff layer so long sessions stay usable.
- Preserve upstream Oracle capabilities when they help, and diverge only where OpenCode-specific needs justify it.
This repo is not a clean-room rewrite. It is an opinionated fork.
Upstream Oracle still provides the core CLI runtime, browser machinery, remote bridge, MCP server, and session model. The plan is to keep syncing with upstream where that improves reliability, while using this fork to move faster on the OpenCode and GPT Pro path.
If you want the general-purpose upstream tool, use steipete/oracle. If you want the OpenCode-first fork direction, use this repo.