docs: add recommended alternative models for explore and librarian agents #447
+8
−8
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…ents - explore: anthropic/claude-haiku-4-5, google/gemini-3-flash - librarian: opencode/minimax-m2.1-free (free tier available) Closes #438
Greptile SummaryThis PR adds recommended alternative model options to documentation for the
Confidence Score: 5/5
Important Files Changed
Sequence DiagramsequenceDiagram
participant User
participant Sisyphus
participant librarian
participant explore
participant Claude_Sonnet as Claude Sonnet 4.5
participant Gemini_Flash as Gemini 3 Flash
participant MiniMax as MiniMax M2.1 (Free)
participant Haiku as Claude Haiku 4.5
participant Grok as Grok Code
User->>Sisyphus: Request multi-repo analysis
activate Sisyphus
Sisyphus->>librarian: Delegate task
activate librarian
alt Antigravity Auth Configured
librarian->>Gemini_Flash: Use as primary
else Default
librarian->>Claude_Sonnet: Use as primary
end
note over librarian: Alternative available:<br/>MiniMax M2.1 (Free)
librarian-->>Sisyphus: Response
deactivate librarian
User->>Sisyphus: Request fast codebase exploration
activate Sisyphus
Sisyphus->>explore: Delegate task
activate explore
alt Antigravity Auth Configured
explore->>Gemini_Flash: Use as primary
else Claude max20 Available
explore->>Haiku: Use alternative
else Default
explore->>Grok: Use as fallback
end
note over explore: Alternatives available:<br/>Haiku 4.5, Gemini 3 Flash
explore-->>Sisyphus: Response
deactivate explore
deactivate Sisyphus
|
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
There was a problem hiding this comment.
2 issues found across 4 files
Confidence score: 4/5
- README documentation repeats the same models in both the primary and alternative lists, which could confuse users selecting an agent.
- The Japanese README mirrors the same redundancy, so the confusion spans multiple language audiences though it’s a doc-only fix.
- Pay close attention to
README.md,README.ja.md- ensure alternative model lists truly differ from primary defaults.
Prompt for AI agents (all issues)
Check if these issues are valid — if so, understand the root cause of each and fix them.
<file name="README.md">
<violation number="1" location="README.md:482">
P2: The models listed as "Alternative" (`anthropic/claude-haiku-4-5`, `google/gemini-3-flash`) are already listed as primary/default models for this agent in the parentheses and description. This is redundant and may confuse users who expect alternatives to be different options. Consider either removing these as alternatives, or suggesting genuinely different models like was done for the librarian agent.</violation>
</file>
<file name="README.ja.md">
<violation number="1" location="README.ja.md:443">
P3: The alternative models listed for explore (`anthropic/claude-haiku-4-5`, `google/gemini-3-flash`) are already included as primary models in the same description. This redundancy may confuse users since these aren't actually "alternatives" but the same options already mentioned. Consider listing a genuinely different model as alternative, or removing this redundant recommendation.</violation>
</file>
Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.
| - **librarian** (`anthropic/claude-sonnet-4-5` or `google/gemini-3-flash`): Multi-repo analysis, doc lookup, implementation examples. Uses Gemini 3 Flash when Antigravity auth is configured, otherwise Claude Sonnet 4.5 for deep codebase understanding and GitHub research with evidence-based answers. Inspired by AmpCode. | ||
| - **explore** (`opencode/grok-code`, `google/gemini-3-flash`, or `anthropic/claude-haiku-4-5`): Fast codebase exploration and pattern matching. Uses Gemini 3 Flash when Antigravity auth is configured, Haiku when Claude max20 is available, otherwise Grok. Inspired by Claude Code. | ||
| - **librarian** (`anthropic/claude-sonnet-4-5` or `google/gemini-3-flash`): Multi-repo analysis, doc lookup, implementation examples. Uses Gemini 3 Flash when Antigravity auth is configured, otherwise Claude Sonnet 4.5 for deep codebase understanding and GitHub research with evidence-based answers. Inspired by AmpCode. **Alternative:** `opencode/minimax-m2.1-free` (free tier available) | ||
| - **explore** (`opencode/grok-code`, `google/gemini-3-flash`, or `anthropic/claude-haiku-4-5`): Fast codebase exploration and pattern matching. Uses Gemini 3 Flash when Antigravity auth is configured, Haiku when Claude max20 is available, otherwise Grok. Inspired by Claude Code. **Alternative:** `anthropic/claude-haiku-4-5`, `google/gemini-3-flash` |
There was a problem hiding this comment.
P2: The models listed as "Alternative" (anthropic/claude-haiku-4-5, google/gemini-3-flash) are already listed as primary/default models for this agent in the parentheses and description. This is redundant and may confuse users who expect alternatives to be different options. Consider either removing these as alternatives, or suggesting genuinely different models like was done for the librarian agent.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At README.md, line 482:
<comment>The models listed as "Alternative" (`anthropic/claude-haiku-4-5`, `google/gemini-3-flash`) are already listed as primary/default models for this agent in the parentheses and description. This is redundant and may confuse users who expect alternatives to be different options. Consider either removing these as alternatives, or suggesting genuinely different models like was done for the librarian agent.</comment>
<file context>
@@ -478,8 +478,8 @@ To remove oh-my-opencode:
-- **librarian** (`anthropic/claude-sonnet-4-5` or `google/gemini-3-flash`): Multi-repo analysis, doc lookup, implementation examples. Uses Gemini 3 Flash when Antigravity auth is configured, otherwise Claude Sonnet 4.5 for deep codebase understanding and GitHub research with evidence-based answers. Inspired by AmpCode.
-- **explore** (`opencode/grok-code`, `google/gemini-3-flash`, or `anthropic/claude-haiku-4-5`): Fast codebase exploration and pattern matching. Uses Gemini 3 Flash when Antigravity auth is configured, Haiku when Claude max20 is available, otherwise Grok. Inspired by Claude Code.
+- **librarian** (`anthropic/claude-sonnet-4-5` or `google/gemini-3-flash`): Multi-repo analysis, doc lookup, implementation examples. Uses Gemini 3 Flash when Antigravity auth is configured, otherwise Claude Sonnet 4.5 for deep codebase understanding and GitHub research with evidence-based answers. Inspired by AmpCode. **Alternative:** `opencode/minimax-m2.1-free` (free tier available)
+- **explore** (`opencode/grok-code`, `google/gemini-3-flash`, or `anthropic/claude-haiku-4-5`): Fast codebase exploration and pattern matching. Uses Gemini 3 Flash when Antigravity auth is configured, Haiku when Claude max20 is available, otherwise Grok. Inspired by Claude Code. **Alternative:** `anthropic/claude-haiku-4-5`, `google/gemini-3-flash`
- **frontend-ui-ux-engineer** (`google/gemini-3-pro-high`): A designer turned developer. Builds gorgeous UIs. Gemini excels at creative, beautiful UI code.
- **document-writer** (`google/gemini-3-flash`): Technical writing expert. Gemini is a wordsmith—writes prose that flows.
</file context>
Suggested change
| - **explore** (`opencode/grok-code`, `google/gemini-3-flash`, or `anthropic/claude-haiku-4-5`): Fast codebase exploration and pattern matching. Uses Gemini 3 Flash when Antigravity auth is configured, Haiku when Claude max20 is available, otherwise Grok. Inspired by Claude Code. **Alternative:** `anthropic/claude-haiku-4-5`, `google/gemini-3-flash` | |
| - **explore** (`opencode/grok-code`, `google/gemini-3-flash`, or `anthropic/claude-haiku-4-5`): Fast codebase exploration and pattern matching. Uses Gemini 3 Flash when Antigravity auth is configured, Haiku when Claude max20 is available, otherwise Grok. Inspired by Claude Code. |
| - **librarian** (`anthropic/claude-sonnet-4-5` または `google/gemini-3-flash`): マルチリポジトリ分析、ドキュメント検索、実装例の調査を担当。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、それ以外は Claude Sonnet 4.5 を使用して、深いコードベース理解と GitHub リサーチ、根拠に基づいた回答を提供します。AmpCode からインスピレーションを得ました。 | ||
| - **explore** (`opencode/grok-code`、`google/gemini-3-flash`、または `anthropic/claude-haiku-4-5`): 高速なコードベース探索、ファイルパターンマッチング。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、Claude max20 が利用可能な場合は Haiku を使用し、それ以外は Grok を使います。Claude Code からインスピレーションを得ました。 | ||
| - **librarian** (`anthropic/claude-sonnet-4-5` または `google/gemini-3-flash`): マルチリポジトリ分析、ドキュメント検索、実装例の調査を担当。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、それ以外は Claude Sonnet 4.5 を使用して、深いコードベース理解と GitHub リサーチ、根拠に基づいた回答を提供します。AmpCode からインスピレーションを得ました。**代替:** `opencode/minimax-m2.1-free` (無料枠あり) | ||
| - **explore** (`opencode/grok-code`、`google/gemini-3-flash`、または `anthropic/claude-haiku-4-5`): 高速なコードベース探索、ファイルパターンマッチング。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、Claude max20 が利用可能な場合は Haiku を使用し、それ以外は Grok を使います。Claude Code からインスピレーションを得ました。**代替:** `anthropic/claude-haiku-4-5`, `google/gemini-3-flash` |
There was a problem hiding this comment.
P3: The alternative models listed for explore (anthropic/claude-haiku-4-5, google/gemini-3-flash) are already included as primary models in the same description. This redundancy may confuse users since these aren't actually "alternatives" but the same options already mentioned. Consider listing a genuinely different model as alternative, or removing this redundant recommendation.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At README.ja.md, line 443:
<comment>The alternative models listed for explore (`anthropic/claude-haiku-4-5`, `google/gemini-3-flash`) are already included as primary models in the same description. This redundancy may confuse users since these aren't actually "alternatives" but the same options already mentioned. Consider listing a genuinely different model as alternative, or removing this redundant recommendation.</comment>
<file context>
@@ -439,8 +439,8 @@ oh-my-opencode を削除するには：
-- **librarian** (`anthropic/claude-sonnet-4-5` または `google/gemini-3-flash`): マルチリポジトリ分析、ドキュメント検索、実装例の調査を担当。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、それ以外は Claude Sonnet 4.5 を使用して、深いコードベース理解と GitHub リサーチ、根拠に基づいた回答を提供します。AmpCode からインスピレーションを得ました。
-- **explore** (`opencode/grok-code`、`google/gemini-3-flash`、または `anthropic/claude-haiku-4-5`): 高速なコードベース探索、ファイルパターンマッチング。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、Claude max20 が利用可能な場合は Haiku を使用し、それ以外は Grok を使います。Claude Code からインスピレーションを得ました。
+- **librarian** (`anthropic/claude-sonnet-4-5` または `google/gemini-3-flash`): マルチリポジトリ分析、ドキュメント検索、実装例の調査を担当。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、それ以外は Claude Sonnet 4.5 を使用して、深いコードベース理解と GitHub リサーチ、根拠に基づいた回答を提供します。AmpCode からインスピレーションを得ました。**代替:** `opencode/minimax-m2.1-free` (無料枠あり)
+- **explore** (`opencode/grok-code`、`google/gemini-3-flash`、または `anthropic/claude-haiku-4-5`): 高速なコードベース探索、ファイルパターンマッチング。Antigravity 認証が設定されている場合は Gemini 3 Flash を使用し、Claude max20 が利用可能な場合は Haiku を使用し、それ以外は Grok を使います。Claude Code からインスピレーションを得ました。**代替:** `anthropic/claude-haiku-4-5`, `google/gemini-3-flash`
- **frontend-ui-ux-engineer** (`google/gemini-3-pro-preview`): 開発者に転身したデザイナーという設定です。素晴らしい UI を作ります。美しく独創的な UI コードを生成することに長けた Gemini を使用します。
- **document-writer** (`google/gemini-3-pro-preview`): テクニカルライティングの専門家という設定です。Gemini は文筆家であり、流れるような文章を書きます。
</file context>
Owner
|
uhm free model is not what i pursue. i just want the best |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Adds recommended alternative model options to all README files (EN, KO, JA, ZH-CN) as requested in #438:
anthropic/claude-haiku-4-5,google/gemini-3-flashopencode/minimax-m2.1-free(free tier available)Changes
Updated the Agents section in all 4 README files to include Alternative: notes with the recommended models.
Closes #438
Summary by cubic
Added recommended alternative models to the explore and librarian agents across all README languages (EN, KO, JA, ZH-CN) to guide model selection and provide a free-tier option. Addresses #438: explore alternatives anthropic/claude-haiku-4-5 and google/gemini-3-flash; librarian alternative opencode/minimax-m2.1-free (free tier available).
Written for commit 3eb2f4e. Summary will update on new commits.