Oracle Advisor for Codex

Oracle Advisor is a local Codex plugin that uses steipete/oracle as an independent second-model reviewer.

It can:

• challenge an implementation plan before material coding;
• review completed code and diffs;
• help arbitrate architecture and debugging decisions;
• continue a saved Oracle conversation with materially new evidence;
• require a preview and explicit approval before every live follow-up.

The plugin runs locally. It does not provide or operate a hosted Oracle service.

Install

Requirements:

• Codex with plugin support;
• Git;
• Node.js 24 or newer;
• an Oracle route configured through an API provider or a signed-in browser.

Add this repository as a marketplace and install the plugin:

codex plugin marketplace add cona88/oracle-advisor
codex plugin add oracle-advisor@cona88-oracle-advisor

Restart Codex and begin a new task so the skill and MCP servers are loaded.

Example requests:

Ask Oracle to challenge this implementation plan before coding.
Ask Oracle to review the implementation I just completed.
Continue the previous Oracle session with these new test results.

Browser sign-in and session persistence

If Oracle uses browser mode, complete the ChatGPT sign-in in the browser profile opened by Oracle. That profile is reused on later calls unless it is removed or the account session expires. Oracle sessions are stored locally under ~/.oracle/sessions.

See the upstream Oracle documentation for provider and browser configuration.

Safety model

• Implicit skill activation is preparation-only.
• Live consultations require explicit approval of files, route, model, cost information, browser behavior, and local persistence.
• oracle_followup uses preview → single-use token → execute.
• Attachments are restricted to exact files inside the active workspace.
• The wrapper rejects likely credentials, symlinks, changed files, changed configuration, stale parent sessions, and reused approval tokens.
• Oracle output is advisory; Codex must verify it against current code and tests.

Read Privacy before using the plugin with sensitive code or data.

Development

Run the regression suite:

npm test

The distributable plugin is under plugins/oracle-advisor, and the Codex marketplace catalog is under /.agents/plugins/marketplace.json.

Attribution and license

Oracle Advisor is an independent integration and is not affiliated with or endorsed by the Oracle upstream project. Oracle is copyright Peter Steinberger and contributors and is available under the MIT License.

This repository is licensed under the MIT License. See NOTICE for full attribution.