https://github.com/fulll/github-code-search
An interactive CLI to search GitHub code across an organization, with per-repository result aggregation, keyboard navigation, and fine-grained extract selection
https://github.com/fulll/github-code-search
cli code-search github tui
Last synced: 26 days ago
JSON representation
An interactive CLI to search GitHub code across an organization, with per-repository result aggregation, keyboard navigation, and fine-grained extract selection
- Host: GitHub
- URL: https://github.com/fulll/github-code-search
- Owner: fulll
- License: mit
- Created: 2026-02-18T22:09:17.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-02-24T01:58:37.000Z (2 months ago)
- Last Synced: 2026-02-24T08:26:24.646Z (2 months ago)
- Topics: cli, code-search, github, tui
- Language: TypeScript
- Homepage: https://fulll.github.io/github-code-search/
- Size: 271 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# github-code-search
[](https://fulll.github.io/github-code-search/)
[](https://github.com/fulll/github-code-search/releases/latest)
Interactive CLI to search GitHub code across an organization — per-repository aggregation,
keyboard-driven TUI, fine-grained extract selection, markdown/JSON output.
→ **Full documentation: https://fulll.github.io/github-code-search/**
## Quick start
**macOS / Linux**
```bash
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
curl -fsSL https://raw.githubusercontent.com/fulll/github-code-search/main/install.sh | bash
github-code-search query "TODO" --org my-org
```
**Windows** (PowerShell)
```powershell
$env:GITHUB_TOKEN = "ghp_xxxxxxxxxxxxxxxxxxxx"
powershell -c "irm https://raw.githubusercontent.com/fulll/github-code-search/main/install.ps1 | iex"
github-code-search query "TODO" --org my-org
```
## Features
- **Org-wide search** — queries all repositories in a GitHub organization in one command, with automatic pagination up to 1 000 results
- **Per-repository aggregation** — results grouped by repo, not as a flat list; fold/unfold each repo to focus on what matters
- **Keyboard-driven TUI** — navigate with arrow keys, toggle selections, filter by file path, confirm with Enter — without leaving the terminal
- **Fine-grained selection** — pick exactly the repos and extracts you want; deselected items are recorded as exclusions in the replay command
- **Structured output** — Markdown document with a `# Results for` query heading, GitHub deeplinks and the exact matched token per extract; or machine-readable JSON that, when segment data is available, includes `matchedText`, `line` and `col` fields — ready to paste into docs, issues or scripts
- **Team-prefix grouping** — group results by team prefix (e.g. `platform/`, `data/`) using `--group-by-team-prefix`
- **Replay command** — every session produces a one-liner you can run in CI to reproduce the exact same selection without the UI
- **Regex search** — use `/pattern/flags` syntax for pattern-based searches; the CLI derives a safe API query and filters results locally
- **Syntax highlighting** — code fragments rendered with language-aware coloring (TypeScript, Python, Go, Rust, YAML, JSON and more)
## Use cases
**Audit a dependency across the org**
```bash
github-code-search query "from 'lodash'" --org my-org
```
Instantly see every repo still importing lodash, select the ones to migrate, and get a Markdown checklist to paste in your migration issue.
**Hunt down TODOs before a release**
```bash
github-code-search query "TODO" --org my-org --exclude-repositories sandbox,archived-repo
```
Surfaces all in-code TODOs, lets you triage interactively, and outputs a linked list for your release notes.
**Verify a breaking-change rollout**
```bash
github-code-search query "oldApiClient" --org my-org --output-type repo-only --format json
```
Use JSON output in a CI script to assert that no repository still references the deprecated client after your migration deadline.
**Security sweep — find hardcoded secret patterns**
```bash
github-code-search query "process.env.SECRET" --org my-org
```
Cross-repo scan for risky patterns; export results to Markdown to attach to a security audit report.
**Onboarding — understand how an internal library is used**
```bash
github-code-search query "useFeatureFlag" --org my-org --group-by-team-prefix platform/
```
Get a team-scoped view of every usage site before refactoring a shared hook or utility.
**Skip template repositories**
```bash
github-code-search query "TODO" --org my-org --exclude-template-repositories
```
Exclude repositories that are marked as GitHub templates, so boilerplate repos don't clutter your results.
**Regex search — pattern-based code audit**
```bash
github-code-search query "/from.*['\"\`]axios/" --org my-org
```
Use `/pattern/` syntax to run a regex search. The CLI automatically derives a safe API query term and filters results locally — no manual post-processing needed. Use `--regex-hint` to override the derived term when auto-extraction is too broad.
## Why not `gh search code`?
The official [`gh` CLI](https://cli.github.com/) does support `gh search code`, but it returns a **flat paginated list** — one result per line, no grouping, no interactive selection, no structured output.
| | `gh search code` | `github-code-search` |
| ------------------------------------------ | :--------------: | :------------------: |
| Results grouped by repo | ✗ | ✓ |
| Interactive TUI (navigate, select, filter) | ✗ | ✓ |
| Fine-grained extract selection | ✗ | ✓ |
| Markdown / JSON output | ✗ | ✓ |
| Replay / CI command | ✗ | ✓ |
| Team-prefix grouping | ✗ | ✓ |
| Regex search | ✗ | ✓ |
| Syntax highlighting in terminal | ✗ | ✓ |
| Pagination (up to 1 000 results) | ✓ | ✓ |
`github-code-search` is purpose-built for **org-wide code audits and interactive triage** — not just a search wrapper.