not-matthias/github-code-search

GitHub Code Search via gh CLI

Search across GitHub's entire codebase using the gh code-search command. This is faster than browsing and helps you find real-world examples of how to structure code, configure tools, or solve problems.

When to Use

• Finding reference implementations (e.g., how others structure flake.nix)
• Learning patterns for specific languages or frameworks
• Discovering how popular projects configure tools
• Finding examples of specific Nix packages or functions
• Researching best practices for code organization

Prerequisites

• gh CLI installed and authenticated (gh auth login)
• Understanding basic GitHub search syntax

Workflow

Step 1: Construct Your Search Query

Use operators and filters to narrow results:

Basic syntax:

gh code-search [query] [flags]

Common operators:

• language:nix - Search only in Nix files
• language:python - Search in Python files
• repo:owner/repo - Limit to specific repository
• filename:flake.nix - Search only in files named flake.nix
• org:nixos - Search within an organization
• stars:>100 - Limit to popular repos (helps avoid noise)

Combining operators:

gh code-search 'stdenv.mkDerivation' language:nix repo:nixos/nixpkgs stars:>50

Step 2: Execute the Search

Run the search and review results:

gh code-search 'search query' language:nix --limit 10

Flags:

• --limit N - Show first N results (default 30, max 100)
• --json - Output as JSON for processing
• --match <field> - Match against: path, symbol, or content (default: content)

Step 3: Navigate Results

Each result shows:

• Repository name
• File path
• Repository description
• URL to view on GitHub

Click or copy the URL to examine the full context in your browser.

Examples

Find Nix Package Examples

Search for how others define packages:

# Look for fetchFromGitHub usage
gh code-search 'fetchFromGitHub' language:nix stars:>50 --limit 10

# Find similar packages (e.g., Rust tools)
gh code-search 'rustPlatform.buildRustPackage' language:nix --limit 20

# Find AppImage packaging examples
gh code-search 'appimageTools' language:nix --limit 5

Find Nix Service Configurations

# Systemd service examples
gh code-search 'systemd.services' language:nix org:nixos --limit 10

# Home Manager module examples
gh code-search 'home.packages' language:nix stars:>100 --limit 15

Find flake.nix Patterns

# Browse flakes with specific input patterns
gh code-search 'inputs.nixpkgs' filename:flake.nix stars:>50 --limit 20

# Find flake outputs patterns
gh code-search 'outputs = {' filename:flake.nix --limit 10

Non-Nix Examples

# Python package examples
gh code-search 'def setup(' language:python filename:setup.py stars:>100

# Rust build patterns
gh code-search 'cargo.toml' language:toml stars:>50

# Shell script patterns
gh code-search '#!/bin/bash' language:shell --limit 10

Advanced Patterns

Exclude Noise

Add negative filters to exclude test files or templates:

gh code-search 'pattern' language:nix -filename:test.nix

Search Organization

Find patterns within the NixOS organization (most authoritative):

gh code-search 'stdenv.mkDerivation' language:nix org:nixos --limit 50

Combine With Local Processing

Export to JSON and process locally:

gh code-search 'query' language:nix --json | jq '.[] | .url' > results.txt

Common Issues

Issue: Too many irrelevant results

• Solution: Add filters like stars:>100 to focus on popular, well-maintained repos. Add org:nixos for authoritative NixOS examples.

Issue: Results seem outdated

• Solution: Focus on recent changes by searching for specific patterns in active projects. Check the repository's last update date on GitHub.

Issue: Can't find specific syntax

• Solution: Try variations of the syntax (e.g., stdenv.mkDerivation vs mkDerivation). Search for similar projects that use the same tool/library.

Tips

• Start broad, narrow down: Begin with simple queries, then add filters based on results
• Use stars for quality: stars:>50 helps surface well-maintained examples
• Check multiple examples: Different people solve problems differently—see 3-5 implementations to find patterns
• Use filename filters: filename:flake.nix is faster than searching content for specific file types
• Bookmark useful repos: When you find a good reference, star it or note the URL for future reference
• Cross-reference: Use multiple searches to find complementary examples

See Also

• gh code-search --help - Full command reference
• https://docs.github.com/en/search-github/searching-on-github/searching-code - GitHub search documentation
• https://github.com/nixos/nixpkgs - Primary Nix package repository for official examples