# uithub - GitHub Repository File URL Extractor

uithub is a service that extracts and lists all file URLs from GitHub repositories by downloading the repository as a zip file and streaming the individual file URLs.

## What it does

- Takes a GitHub repository URL path
- Downloads the repository as a zip file from GitHub's API
- Extracts all file paths from the zip
- Returns a list of raw.githubusercontent.com URLs for each file
- Caches the results in KV storage for 1 hour

## URL Format

```
https://llms.uithub.com/{owner}/{repo}[/tree/{branch}]
```

## Examples

Get all files from the main branch:
```
https://llms.uithub.com/microsoft/vscode
```

Get files from a specific branch:
```
https://llms.uithub.com/facebook/react/tree/main
```

Get files from a specific branch with slashes in the name:
```
https://llms.uithub.com/owner/repo/tree/feature/my-branch
```

## Output

Returns a plain text list of URLs, one per line:
```
https://raw.githubusercontent.com/owner/repo/refs/heads/main/README.md
https://raw.githubusercontent.com/owner/repo/refs/heads/main/package.json
https://raw.githubusercontent.com/owner/repo/refs/heads/main/src/index.js
...
```

## Authentication

Requires GitHub authentication via:
- Cookie-based auth (login at `/authorize`)
- Authorization header with GitHub token

Perfect for LLMs that need to access all files in a repository programmatically.