Local-first GitHub repository browsing tool for Agents. Inspired by github-llm.
Unlike the Cloudflare Worker version (github-llm), this tool runs locally on your machine. No deployment needed—just install and use.
Advantages:
- No Cloudflare account required
- Token stored locally, never leaves your machine
- Works offline after initial setup
- Zero infrastructure cost
git clone https://github.com/tizee/gh-llm
cd gh-llm
uv sync# Using uv tool (recommended - no need to activate virtualenv)
make install-tool
# Or using pip
uv pip install -e .# Auto-detect from gh CLI (if installed)
gh-llm setup
# Or provide manually
gh-llm setup --token ghp_xxxxxxxxxxxxxxxxxxxxThe token is stored in ~/.config/gh-llm/token.
# List repository contents
gh-llm ls octocat/Hello-World
gh-llm ls octocat/Hello-World --ref main
# List with JSON output (great for LLMs)
gh-llm ls octocat/Hello-World --json
# View file contents
gh-llm cat octocat/Hello-World README.md
gh-llm cat octocat/Hello-World src/main.py --ref develop
# Check configuration
gh-llm status| Command | Description |
|---|---|
setup |
Configure GitHub token |
ls / tree |
List directory contents |
cat |
Display file contents |
status |
Show configuration status |
- Unauthenticated: 60 requests/hour per IP
- Authenticated: 5,000 requests/hour
For public repositories, authentication is optional but recommended for higher rate limits.
# Install dependencies
uv sync
# Run tests
make test
# Lint & format
make lint
make fmt
# Type check
make typecheckMIT