# gitquarry ## Docs - [auth](https://gitquarry.micr.dev/commands/auth.md): Reference for gitquarry auth login, status, and logout, including validation and host-scoped credential behavior. - [code](https://gitquarry.micr.dev/commands/code.md): Reference for gitquarry code, the no-clone repository code search command. - [compare](https://gitquarry.micr.dev/commands/compare.md): Reference for gitquarry compare, the side-by-side explicit repository comparison command. - [config](https://gitquarry.micr.dev/commands/config.md): Reference for gitquarry config path and config show, including what can and cannot be saved. - [inspect](https://gitquarry.micr.dev/commands/inspect.md): Reference for gitquarry inspect, including metadata-first output, README inclusion, and supported formats. - [mcp](https://gitquarry.micr.dev/commands/mcp.md): Run gitquarry as a stdio Model Context Protocol server. - [recipe](https://gitquarry.micr.dev/commands/recipe.md): Reference for gitquarry recipe run, the TOML search recipe command. - [search](https://gitquarry.micr.dev/commands/search.md): Reference for gitquarry search, including native behavior, discover mode, structured flags, and output formats. - [skills](https://gitquarry.micr.dev/commands/skills.md): Reference for gitquarry skills - embedded, version-matched guidance for agents and automation. - [source](https://gitquarry.micr.dev/commands/source.md): Reference for gitquarry source path, the explicit opensrc-backed source retrieval command. - [tree](https://gitquarry.micr.dev/commands/tree.md): Reference for gitquarry tree, the no-clone repository tree inspection command. - [Authentication](https://gitquarry.micr.dev/guides/authentication.md): Understand PAT requirements, host-scoped storage, environment precedence, and explicit insecure fallback. - [Discovery Mode](https://gitquarry.micr.dev/guides/discovery-mode.md): Understand when to stay native and when to opt into bounded candidate collection, enrichment, and reranking. - [GitHub Enterprise Hosts](https://gitquarry.micr.dev/guides/github-enterprise-hosts.md): Use gitquarry against GitHub Enterprise or non-default hosts with correct normalization, auth, and config isolation. - [Installation](https://gitquarry.micr.dev/guides/installation.md): Install gitquarry with npm, pnpm, Bun, Homebrew, Scoop, AUR, GitHub Releases, Nix, or from source. - [Output And Scripting](https://gitquarry.micr.dev/guides/output-and-scripting.md): Use gitquarry safely in scripts, pipelines, CI, and agent workflows. - [Quickstart](https://gitquarry.micr.dev/guides/quickstart.md): Get to a first successful gitquarry command quickly, then move from native search into explicit discovery. - [Search Recipes](https://gitquarry.micr.dev/guides/search-recipes.md): Copy-paste search patterns for native GitHub-like search, discover mode, structured filters, and scripting. - [Shell Completion](https://gitquarry.micr.dev/guides/shell-completion.md): Generate and install gitquarry completions for Bash, Zsh, Fish, and PowerShell. - [Troubleshooting](https://gitquarry.micr.dev/guides/troubleshooting.md): Fix the most common gitquarry problems quickly, from auth failures to flag conflicts and host mistakes. - [Introduction](https://gitquarry.micr.dev/index.md): Gitquarry is a GitHub repository search CLI that keeps native search native and makes enhanced discovery explicit. - [Architecture](https://gitquarry.micr.dev/project/architecture.md): Full system architecture and request pipeline contract for gitquarry. - [Architecture And Spec](https://gitquarry.micr.dev/project/architecture-and-spec.md): Understand the product contract and system structure that constrain gitquarry changes. - [Benchmark Study](https://gitquarry.micr.dev/project/benchmark-study.md): A decision-grade benchmark study for gitquarry search modes, depths, rank strategies, and optional filters. - [Contributing](https://gitquarry.micr.dev/project/contributing.md): How to approach changes to gitquarry without breaking the product contract. - [Development](https://gitquarry.micr.dev/project/development.md): Build, test, and validate gitquarry locally. - [Packaging And Release](https://gitquarry.micr.dev/project/packaging-and-release.md): Understand how GitHub Releases, npm, Homebrew, Scoop, AUR, Nix, and repo-local packaging files fit together. - [Security And Auth Safety](https://gitquarry.micr.dev/project/security-and-auth-safety.md): Understand token handling, insecure fallback boundaries, and safe local verification practices. - [Specification](https://gitquarry.micr.dev/project/specification.md): Full product contract for gitquarry v1. - [Testing And Release](https://gitquarry.micr.dev/project/testing-and-release.md): See how gitquarry is verified locally, in CI, and during release and live-smoke workflows. - [CLI Overview](https://gitquarry.micr.dev/reference/cli-overview.md): See the full gitquarry command surface, global options, root commands, and completion support in one place. - [Config And Credentials](https://gitquarry.micr.dev/reference/config-and-credentials.md): Understand config file fields, path resolution, host-scoped auth precedence, env vars, and insecure fallback rules. - [Engine Internals](https://gitquarry.micr.dev/reference/engine-internals.md): Understand native search, discover-mode expansion, scoring, retries, and bounded enrichment. - [Error Reference](https://gitquarry.micr.dev/reference/error-reference.md): Reference for common gitquarry error codes and what they mean. - [Output Contract](https://gitquarry.micr.dev/reference/output-contract.md): Understand stdout, stderr, output formats, progress behavior, and scripting expectations. - [Output Schemas](https://gitquarry.micr.dev/reference/output-schemas.md): See the exact JSON and CSV output shapes used by gitquarry commands. - [Search Behavior](https://gitquarry.micr.dev/reference/search-behavior.md): Reference for the native-versus-discover split, host support, bounded discovery, and ranking semantics. - [Release runbook](https://gitquarry.micr.dev/release-runbook.md) - [Automation Patterns](https://gitquarry.micr.dev/wiki/automation-patterns.md): Use gitquarry in shell pipelines, scripts, CI jobs, and agent workflows without breaking its contracts. - [FAQ](https://gitquarry.micr.dev/wiki/faq.md): Fast answers to common product, search, auth, and packaging questions about gitquarry. - [Native Vs Discover](https://gitquarry.micr.dev/wiki/native-vs-discover.md): Compare the two search modes side by side and choose the right one for the job. - [Repository Signals](https://gitquarry.micr.dev/wiki/repository-signals.md): Understand which repository fields matter in native search, inspect output, and explicit ranking modes. - [Troubleshooting Playbook](https://gitquarry.micr.dev/wiki/troubleshooting-playbook.md): A longer operator-focused playbook for debugging auth, search, output, host, and release-surface issues. ## OpenAPI Specs - [openapi](https://gitquarry.micr.dev/api-reference/openapi.json) ## Optional - [GitHub](https://github.com/Microck/gitquarry) - [Releases](https://github.com/Microck/gitquarry/releases) - [Changelog](https://github.com/Microck/gitquarry/blob/main/CHANGELOG.md)