RRepoGEO

REPOGEO REPORT · LITE

bakks/butterfish

Default branch main · commit 313e6c19 · scanned 6/2/2026, 10:11:51 PM

GitHub: 528 stars · 63 forks

AI VISIBILITY SCORE
35 /100
Critical
Category recall
0 / 2
Not recommended in any query
Rule findings
1 pass · 1 warn · 0 fail
Objective metadata checks
AI knows your name
3 / 3
Direct prompts that named your repo
HOW TO READ THIS REPORT

Action plan is what to do next — copy-pasteable changes prioritized by impact. Category visibility is the real GEO test: when a user asks an AI a brand-free question that should surface bakks/butterfish, does the AI actually recommend you — or your competitors? Objective checks verify the metadata signals AI engines weight first. Self-mention check detects whether AI even knows you exist by name.

Action plan — copy-paste fixes

2 prioritized changes generated by gemini-2.5-flash. Mark items done after you ship the fix.

OVERALL DIRECTION
  • highreadme#1
    Reposition the README's introductory paragraph for clarity

    Why:

    CURRENT
    # 🐠 Butterfish Shell

A shell with AI superpowers

...

## What is this thing?

Butterfish is for people who work from the command line, it adds AI prompting to your shell (bash, zsh) with OpenAI. Think Github Copilot for shell.
    COPY-PASTE FIX
    # 🐠 Butterfish Shell

Butterfish is an AI-powered shell assistant that brings ChatGPT-like capabilities directly to your command line (bash, zsh), offering contextual suggestions and debugging help. Think GitHub Copilot for your shell, designed for command-line users.
  • mediumcomparison#2
    Add a dedicated comparison section to the README

    Why:

    COPY-PASTE FIX
    ## How Butterfish Compares

Butterfish stands out from other AI-powered shell tools like Fig AI, Warp, Aider, Shell Genie, and GitHub Copilot CLI by offering a unique 'no copy/pasting' experience. It integrates directly into your existing shell (bash, zsh) and provides high-context AI help by seeing your full shell history. This enables advanced features like contextual debugging ('Why did that command fail?') and agent-like execution ('!Run make in this directory, debug problems'), without requiring you to leave your terminal or manually paste commands.

Category GEO backends resolved for this scan: google/gemini-2.5-flash, deepseek/deepseek-v4-flash

Category visibility — the real GEO test

Brand-free queries asked to google/gemini-2.5-flash. Did AI recommend you, or someone else?

Same questions for every model — switch tabs to compare answers and rankings.

Recall
0 / 2
0% of queries surface bakks/butterfish
Avg rank
—
Lower is better. #1 = top recommendation.
Share of voice
0%
Of all named tools, what % are you?
Top rival
Aider
Recommended in 2 of 2 queries
COMPETITOR LEADERBOARD
  1. Aider · recommended 2×
  2. Shell Genie · recommended 2×
  3. GitHub Copilot CLI · recommended 2×
  4. Fig · recommended 1×
  5. Warp · recommended 1×
  • CATEGORY QUERY
    How can I get AI-powered command line suggestions and debugging help directly in my shell?
    you: not recommended
    AI recommended (in order):
    1. Fig
    2. Warp
    3. Aider
    4. Shell Genie
    5. GitHub Copilot CLI
    6. ai-shell
    7. OpenAI API

    AI recommended 7 alternatives but never named bakks/butterfish. This is the gap to close.

    Show full AI answer
  • CATEGORY QUERY
    What tools integrate AI into my existing shell for smarter command execution and history context?
    you: not recommended
    AI recommended (in order):
    1. Fig AI
    2. Aider
    3. Shell Genie
    4. Atuin
    5. GitHub Copilot CLI
    6. ai-shell (by mshumer)
    7. Open Interpreter

    AI recommended 7 alternatives but never named bakks/butterfish. This is the gap to close.

    Show full AI answer

Objective checks

Rule-based audits of metadata signals AI engines weight most.

  • Metadata completeness
    warn

    Suggestion:

  • README presence
    pass

Self-mention check

Does AI even know your repo exists when asked about it directly?

  • Compared to common alternatives in this category, what is the core differentiator of bakks/butterfish?
    pass
    AI named bakks/butterfish explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

  • If a team adopts bakks/butterfish in production, what risks or prerequisites should they evaluate first?
    pass
    AI named bakks/butterfish explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

  • In one sentence, what problem does the repo bakks/butterfish solve, and who is the primary audience?
    pass
    AI named bakks/butterfish explicitly

    AI answers can be confidently wrong. Read for accuracy: does it match your actual tech stack, audience, and differentiator?

Embed your GEO score

Drop this badge into the README of bakks/butterfish. It auto-updates whenever the report is rescanned and links back to the latest report — easy public proof that you care about AI discoverability.

RepoGEO badge previewLive preview
MARKDOWN (README)
[![RepoGEO](https://repogeo.com/badge/bakks/butterfish.svg)](https://repogeo.com/en/r/bakks/butterfish)
HTML
<a href="https://repogeo.com/en/r/bakks/butterfish"><img src="https://repogeo.com/badge/bakks/butterfish.svg" alt="RepoGEO" /></a>
Pro

Subscribe to Pro for deep diagnoses

bakks/butterfish — Lite scans stay free; this card itemizes Pro deep limits vs Lite.

  • Deep reports10 / month
  • Brand-free category queries5 vs 2 in Lite
  • Prioritized action items8 vs 3 in Lite