Oracle CLI

oracle

CLI и MCP-сервер: упаковывает промпт и выбранные файлы проекта и отправляет другой модели за вторым мнением, ответ сохраняется как сессия

4 064 ★ репозитория
Последний коммит 23 окт. 2026
MIT

CLIНужен VPN

steipete/oracleАвтор:Peter Steinberger

Установка

Работает в: Claude Code
Codex
Cursor

Ручная установка

npm install -g @steipete/oracle

Нужен Node.js 24. Для проверки без установки подойдет npx -y @steipete/oracle --help.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Содержимое выбранных файлов уходит внешним провайдерам, а в них бывают секреты
Браузерный режим управляет Chrome и использует вашу залогиненную сессию ChatGPT или Gemini
API-режим тратит платные токены по ключам провайдеров

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Oracle собирает запрос из промпта и файлов, которые вы выбрали флагами --file, и отправляет другой модели: через API или через вашу сессию ChatGPT и Gemini в браузере. Файлы можно задавать путями, папками и glob-масками с исключениями через !. Команда oracle --render печатает точный запрос с пронумерованными строками файлов и никуда его не шлет, так что бандл можно проверить заранее. Каждый запуск пишется в ~/.oracle/sessions, поэтому длинный ответ дожидается в фоне, а позже его можно открыть командой oracle session или продолжить через --followup. Флаг --models запускает сразу несколько API-моделей и фиксирует расходы и сбои по каждой. В репозитории лежат скиллы oracle и `oracle-advisor`, а сервер `oracle-mcp` подключается к агенту по stdio.

Для кого. Для разработчиков, у которых Claude Code или Codex застрял на задаче и нужен независимый разбор от другой сильной модели с контекстом всего проекта.

Подходит, если

Агент не может найти причину гонки данных, и нужен второй взгляд на модули `runner` целиком
Перед релизом хотите ревью package.json и конфигов от модели другого вендора
Нужен ответ Pro-модели ChatGPT по подписке без API-ключа через браузерный режим
Сравниваете ответы нескольких моделей на один вопрос по коду через --models
Агенту нужна консультация из MCP: он вызывает инструмент `consult`

Не подходит, если

В файлах есть секреты или код, который нельзя отправлять внешнему провайдеру
Задача мелкая: пара строк правится быстрее самим агентом без второй модели
Нет Node.js 24 и вы не хотите его ставить: версия ниже не подходит
Нужен полностью локальный запуск: Oracle отправляет контекст в облачные модели

Пример запроса к агенту

Запусти oracle по файлам src/oracle без тестов и попроси найти гонки данных в раннере моделей

Ограничения

Нужен Node.js 24 или новее. API-режим требует ключа выбранного провайдера: OpenAI, Azure OpenAI, Anthropic, Gemini, xAI или OpenRouter. Браузерный режим работает через Chrome и разовый вход в ChatGPT или Gemini, поэтому зависит от их интерфейса. API OpenAI и Anthropic из России недоступны, а браузерный режим работает, только пока вам доступны сайты ChatGPT или Gemini с вашим аккаунтом. Ответы моделей автор советует считать подсказкой и сверять с кодом и тестами.

Как отключить. Удалите пакет: npm uninstall -g @steipete/oracle или brew uninstall oracle. Уберите `oracle-mcp` из конфигурации MCP агента. Сохраненные сессии лежат в ~/.oracle/sessions, удалите папку вручную.

Частые вопросы

Как проверить, что Oracle отправит модели, до запуска?

Выполните oracle --render с промптом и --file. Команда печатает запрос с пронумерованными строками файлов, не требует ключей и не обращается к модели. Оценку токенов и список файлов дает --dry-run summary --files-report.

Нужен ли API-ключ для Oracle?

Нет, если вы работаете в браузерном режиме: он использует вашу сессию ChatGPT или Gemini в Chrome. Oracle выбирает API, когда есть ключ OpenAI, и браузер в остальных случаях. Выбрать вручную можно флагами --engine api и --engine `browser`.

Как подключить Oracle к Claude Code как MCP?

Сервер называется `oracle-mcp` и работает по stdio. Его инструмент `consult` принимает промпт, список файлов, модель и движок, а с waitForCompletion `false` сразу возвращает sessionId.

Можно ли вернуться к ответу, который шел долго?

Да. Запуски лежат в ~/.oracle/sessions. Команда oracle status --hours 72 показывает недавние, oracle session подключает к запуску, oracle `restart` повторяет его.

Что Oracle умеет, кроме текстовых консультаций?

Инструмент chatgpt_image в MCP генерирует картинки через браузерный ChatGPT и сохраняет файл в ORACLE_HOME_DIR/generated. Путь вывода за пределами этой папки по умолчанию запрещен.

Обсуждение

Вопросов и отзывов пока нет.

CLI-инструменты

Octocode

Официальный

MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов

MCP-серверРасширенный доступ955

Gemini MCP Tool

Нужен VPN

MCP-сервер, который дает агенту обращаться к Gemini через его CLI для разбора больших файлов и целых кодовых баз

MCP-серверРасширенный доступ2,3 тыс.

trace-mcp

MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов

MCP-серверРасширенный доступ193

ripwire

CLI и MCP-сервер без зависимостей: строит по репозиторию граф вызовов, чтобы агент понял код без чтения файлов целиком

CLIРасширенный доступ2,5 тыс.

Lineai MCP Server

lineai-mcp-server

Официальный

MCP-сервер платформы Lineai (бывший CodeLogic): анализ влияния изменений кода и базы данных по графу зависимостей

MCP-серверРасширенный доступ37

Context+

MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу

MCP-серверРасширенный доступ2 тыс.

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

Запись	Официальный	Авторизация	Звезды репозитория	Главное отличие
Oracle (эта запись)	нет		4 064
PAL MCP	нет	ключ необязателен	11 802	MCP-сервер, который сам вызывает несколько моделей из агента; Oracle упаковывает файлы и работает еще и через браузерную сессию
Плагин Codex для Claude Code	нет		34 511	плагин ревью силами Codex внутри Claude Code
Agent Scripts	нет		7 399	личный набор автора

Коротко о README

Описание начинается с установки через Homebrew или npm и быстрого старта с безопасным режимом --render. Дальше разобраны три пути: API, браузер и ручной бандл. Отдельные разделы объясняют, как задавать контекст масками файлов, как хранятся сессии и как гонять несколько моделей. Для агентов указаны сервер `oracle-mcp` и скилл из репозитория, а документация собрана на сайте askoracle.sh.

Бейдж для README

Исходный SKILL.md

---
name: oracle
description: "Oracle second-model review: bundle prompts/files, debug, refactor, design."
---

# Oracle (CLI) — best use

Oracle bundles a prompt and selected files into a one-shot request so another
model can answer with real repository context through the API or browser. A
prompt is required; attach files only when they add necessary context. Treat
responses as advisory and verify them against the codebase and tests.

## Main use case (browser, GPT-5.6)

Use browser mode with GPT-5.6 when the ChatGPT account exposes it. GPT-5.6 Sol
and GPT-5.6 Sol Pro are distinct targets: base Sol uses the Extra High effort
setting, while Pro is a separate picker target for difficult or long-running
work.

Recommended defaults:

- Engine: browser (`--engine browser`)
- Base Sol: `--model gpt-5.6-sol`
- Base Sol maximum reasoning: `--browser-thinking-time extra-high` (Extra High)
- Explicit Pro effort on GPT-5.6 Sol: `--browser-thinking-time pro` (fails closed if Pro cannot be confirmed)
- Browser GPT-5.5 with Pro effort: `--model gpt-5.5 --browser-thinking-time pro`
- API Pro maximum reasoning: `--model gpt-5.6-sol --reasoning-mode pro --reasoning-effort max`
- Fallback: explicitly use `--model gpt-5.5-pro` when GPT-5.6 is unavailable
- Attachments: directories/globs plus excludes; never attach secrets by default

GPT-5.6 availability is account-dependent. Confirm the base Sol picker and
retain model-selection evidence. A bare `Pro` picker label proves picker
selection but does not, by itself, prove the server-side Pro generation.

## GPT-5.6 model selection

This version supports GPT-5.6 on both surfaces, but Pro selection differs:

- `gpt-5.6`: follow the GPT-5.6 family default
- `gpt-5.6-sol`: pin ChatGPT's `GPT-5.6 Sol` entry
- Browser: `gpt-5-pro` selects ChatGPT's `Pro` target
- API: `--reasoning-mode pro` enables Pro execution on `gpt-5.6-sol`; pair it with `--reasoning-effort max` for maximum reasoning

For base Sol, use:

```bash
oracle --engine browser --browser-manual-login --model gpt-5.6-sol \
  --browser-thinking-time extra-high \
  -p "<task>" --file "src/**"
```

For GPT-5.6 Sol Pro through the Responses API, use:

```bash
oracle --engine api --model gpt-5.6-sol \
  --reasoning-mode pro \
  --reasoning-effort max \
  -p "<task>" --file "src/**"
```

Сообщить о проблеме