What's New

Multiple Authentication Methods

• Vertex AI Express support — Use VERTEX_API_KEY for Gemini 3 Pro access
• OAuth login — Run oracle login to authenticate with your Google account
• Flexible auth priority — Tries Vertex → OAuth → API key automatically
• Fixed OAuth blocking bug — OAuth/Vertex users were incorrectly rejected (#2)

FULLAUTO_CONTEXT.md Protection

• Auto-health check — Every oracle command now verifies FULLAUTO_CONTEXT.md is tracked in git
• Auto-fix .gitignore — If accidentally gitignored, Oracle removes it and adds a warning comment
• Untracked file warnings — Reminds you to git add if the file isn't tracked

FULLAUTO Mode Improvements

• Cost/time optimization rules — Guidance on respecting cloud compute costs
• Mandatory Oracle check-ins — Enforced consultation during long-running tasks (training, deployment)
• Clarifying questions handling — Workflow for investigating and answering Oracle's questions
• Sleep command clarity — Must actually run sleep N via Bash, not just say "I'll sleep"
• Stripped instructions from context — Oracle no longer sees fullauto.md instructions in FULLAUTO_CONTEXT.md

Bug Fixes

• Fixed: OAuth and Vertex authentication blocked by early API key check (#2, thanks @antoncoding)
• Fixed: Line ending issues

Stats

• 16 commits since v1.1.0

Highlights

• Cross-platform installation — Full support for Linux, macOS, and WSL with automatic line ending normalization
• Intelligent response routing — Oracle now distinguishes between strategic questions and implementation requests
• FULLAUTO recovery system — Automatic instruction persistence across conversation compaction

New Features

Oracle Response Types

The Oracle now automatically selects the appropriate response format:

• strategic_advice — Direct answers for questions and recommendations
• implementation_plan — Structured execution plans with steps, risks, and success criteria

Cross-Platform Installer

• Automatic CRLF → LF conversion during installation
• Shell detection (bash, zsh, profile) with appropriate PATH configuration
• Python 3.8+ validation with clear error messaging
• Cleanup of conflicting prior installations

FULLAUTO Enhancements

• Full /fullauto instructions are now appended to FULLAUTO_CONTEXT.md on each Oracle invocation
• Protected section with clear demarcation prevents accidental modification
• Ensures instruction continuity after context compaction

Improvements

• Upgraded to Gemini 3 Pro with updated API syntax
• Image generation now uses gemini-3-pro-image-preview with streaming support
• Added .gitattributes for consistent line endings across contributors
• Improved Oracle system prompt with clearer role definition

Bug Fixes

• Fixed recursive "consult the Oracle" steps in implementation plans
• Fixed bash\r: command not found errors on Windows-cloned repositories
• Fixed oracle wrapper path resolution when invoked from PATH

Technical Summary

• 16 commits
• 7 files changed (+2,399 / -2,192)

Compatibility

Fully backward compatible with v1.0.0. No migration steps required.

Initial release.

Features

• oracle ask - Strategic planning and code review with Gemini
• oracle ask --files - Attach code files for review
• oracle ask --image - Analyze screenshots and diagrams
• oracle imagine - Image generation (auto-provisions US server if geo-restricted)
• oracle quick - Quick one-off questions
• oracle history - Conversation memory (5 exchanges per project)
• /fullauto - Claude Code slash command for autonomous multi-model workflows

Install

git clone https://github.com/n1ira/claude-oracle.git
cd claude-oracle
./install.sh