oracle

• Вы хотите задать большой AI-модели (GPT‑5.2 Pro, Gemini, Claude и т.д.) глубокий вопрос о вашей кодовой базе и нужно, чтобы она видела соответствующие исходные файлы, а не просто фрагмент.
• Вам нужен режим «долгого размышления» — задачи, которые занимают от 10 минут до часа, — и нужна сохранённая сессия, к которой можно переподключиться, если CLI завершится по таймауту.
• Вам нужно точно контролировать, какие файлы включаются в пакет (с помощью глобов, исключений и учёта .gitignore), чтобы расход токенов оставался предсказуемым.
• Вы хотите предварительно просмотреть полную полезную нагрузку и стоимость в токенах с помощью --dry-run, прежде чем отправлять что-либо в модель.

• Вам нужен контекст многоходового диалога в реальном времени с множеством обменов репликами — запуски oracle одноразовые; предыдущие запуски не запоминаются без повторного подключения сохранённой сессии.
• Вы хотите использовать модель, отличную от GPT или Gemini, через браузерный движок — для этого требуется --engine api (Claude, Grok, Codex и др.).
• Размер ваших контекстных файлов превышает 1 МБ — oracle отклоняет файлы, превышающие этот лимит.

oracle объединяет ваш промпт с любым количеством файлов, директорий или glob-шаблонов в единый запрос. Передавайте --file несколько раз, комбинируйте включения и исключения с префиксом !, а oracle автоматически пропускает node_modules, dist, .git и другие лишние директории.

Режим --engine browser управляет ChatGPT или Gemini напрямую в сеансе браузера — идеально подходит для моделей, доступных только через веб-интерфейс. Он автоматически определяет, вставлять ли содержимое в текстовое поле или загружать его как вложение, в зависимости от размера (до ~60 тыс. символов — вставка в поле, далее — загрузка файла).

Все запуски хранятся в ~/.oracle/sessions. Если долгий запуск браузера отключился или завершился по таймауту, используйте oracle status --hours 72 для просмотра недавних сессий и oracle session <id> --render для повторного подключения — нет необходимости запускать заново и тратить токены.

Запустите --dry-run summary или --dry-run full в сочетании с --files-report, чтобы точно увидеть, что именно будет отправлено, и оценить стоимость в токенах до выполнения реального запроса. Это позволяет избежать неожиданного перерасхода при работе с большими кодовыми базами.

Когда переменная OPENAI_API_KEY задана (или явно указан флаг --engine api), oracle направляет запросы через API вместо браузера. Это открывает доступ к Claude, Grok, Codex и мультимодельным рабочим процессам, которые не поддерживаются браузерным движком.

Запустите хост автоматизации браузера на удалённой машине с помощью oracle serve --host 0.0.0.0 --port 9473 --token <secret>, а затем подключите к нему любой клиент oracle. Полезно для переноса длительных браузерных сессий на сервер.

Разработчик собирает нужные файлы src/** вместе с подробным промптом, описывающим баг, текст ошибки и ограничения, затем запускает oracle --engine browser --model gpt-5.2-pro. Модель получает полный контекст и возвращает план патча. Если сессия прерывается через 20 минут, разработчик повторно подключается к ней, а не запускает процесс заново.

Прежде чем запускать затратный процесс, разработчик выполняет oracle --dry-run summary --files-report -p "<task>" --file "src/**", чтобы увидеть, какие файлы будут включены и сколько токенов они потребуют, а затем сокращает набор файлов перед реальным запуском.

Когда движок браузера не подходит, разработчик использует oracle --render --copy -p "<task>" --file "src/**" для рендеринга полного собранного промпта в буфер обмена, после чего вручную вставляет его в любой чат-интерфейс.

Для сложной многодневной отладки разработчик создаёт отдельный файл промпта с описанием проекта из 6–30 предложений, шагами воспроизведения и точными сообщениями об ошибках, а затем прикрепляет все необходимые файлы конфигурации и точек входа. Промпт является самодостаточным, поэтому одна и та же команда oracle может быть запущена повторно спустя несколько дней с идентичным контекстом.