Skip to main content

Native Vs Discover

Gitquarry has two search personalities on purpose.

Side-By-Side

QuestionNativeDiscover
Default modeYesNo
One GitHub search requestYesNot necessarily
Native orderingYesOnly with --rank native
Local rerankingNoYes
README enrichmentNoOptional
Best forpredictable GitHub-style searchbroader retrieval and explicit ranking

Use Native When

  • you want GitHub-like behavior
  • you care about plain query semantics
  • you want the lightest request path
  • you are scripting around a stable upstream-like result set
Example:
gitquarry search "rust cli" --sort stars

Use Discover When

  • one search page is not enough
  • you want ranking by activity or quality
  • README text should influence final ordering
  • you want --explain
Example:
gitquarry search "release automation" \
  --mode discover \
  --rank blended \
  --readme \
  --explain

Mental Shortcut

  • native = “GitHub search from the terminal”
  • discover = “broader candidate collection plus explicit local ranking”