⚡ Lightning-fast GitHub repository analysis without cloning
Git Seer is a powerful CLI tool that provides instant insights into any public GitHub repository. Get comprehensive overviews of project structure, dependencies, languages, and potential security concerns—all without downloading a single file.
- 📊 Repository Analytics - Stars, forks, issues, and description at a glance
- 🗂️ Project Structure Analysis - Detect monorepos, Django projects, Docker setups
- 🔍 Language Detection - Identify primary programming languages and file counts
- 📦 Dependency Scanning - Find package.json, requirements.txt, and other dependency files
- 🚩 Security Insights - Flag potential secrets, credentials, and sensitive files
- ⚡ Zero Clone Required - Leverages GitHub API for instant analysis
Clean, formatted terminal output with rich tables and panels
python seer.py owner/repositoryFull-featured terminal user interface with expandable file tree navigation
python seer-tui.py owner/repository- Python 3.8 or higher
- Internet connection (for GitHub API access)
-
Clone the repository
git clone https://github.com/LMLK-Seal/git-seer.git cd git-seer -
Install dependencies
pip install -r requirements.txt
# Analyze any public GitHub repository
python seer.py microsoft/vscode
python seer.py facebook/react
python seer.py your-username/your-repoExample Output:
┌─ Oracle Report for microsoft/vscode ──────────────────────────┐
│ ⭐ 162,847 │ 🍴 28,234 │ 🐞 6,543 issues │
│ Visual Studio Code │
└──────────────────────────────────────────────────────────────┘
🗣️ Top Languages TypeScript (2,847 files), JavaScript (1,234 files)
🏛️ Architecture 📦 'src' layout detected
🐳 Dockerized environment
🔄 CI/CD configured (GitHub Actions)
📦 Dependencies Found: package.json, yarn.lock
🚩 Red Flags ✅ No obvious secret files found.
# Launch interactive file explorer
python seer-tui.py microsoft/vscodeTUI Features:
- 📂 Expandable file tree - Navigate repository structure visually
- ⌨️ Keyboard shortcuts -
qto quit,tto toggle theme - 🎨 Dark/Light themes - Toggle between visual modes
- 🔄 Real-time loading - Asynchronous data fetching with status updates
- GitHub REST API - Repository metadata and file tree retrieval
- Rate Limiting Aware - Handles API limits gracefully
- Fallback Logic - Attempts both
mainandmasterbranches
# Smart project detection
def analyze_project_structure(tree: list) -> list:
# Detects: src/ layouts, monorepos, Django, Docker, CI/CD- Rich Library - Beautiful tables, panels, and progress indicators
- Textual Framework - Interactive TUI components and widgets
- Typer CLI - Type-safe command-line argument parsing
git-seer/
├── seer.py # Standard CLI interface
├── seer-tui.py # Interactive TUI interface
├── requirements.txt # Python dependencies
└── README.md # This documentation
| Package | Purpose | Version |
|---|---|---|
requests |
GitHub API communication | Latest |
typer |
CLI framework | Latest |
rich |
Terminal formatting | Latest |
textual |
TUI framework | Latest |
Install all dependencies:
pip install requests typer rich textual- ✅ Source Layouts -
src/directory organization - ✅ Monorepos -
packages/orapps/structure - ✅ Framework Detection - Django (
manage.py), etc. - ✅ Containerization - Docker and docker-compose files
- ✅ CI/CD Pipelines - GitHub Actions workflows
Supports detection of:
- 🐍 Python
- 🟨 JavaScript/TypeScript
- 🦀 Rust
- ☕ Java
- 💎 Ruby
- 🐹 Go
- ⚡ C/C++
- 📝 Markdown, HTML, CSS, YAML, JSON
Flags potentially sensitive files:
- 🔑
.envfiles - 🔐 Credential files
- 🗝️ SSH keys (
id_rsa,.pem) - 🚫 Other secret-containing files
- Quick Repository Assessment - Understand project structure before cloning
- Technology Stack Discovery - Identify languages and frameworks used
- Security Auditing - Spot potential security issues in public repos
- Code Review Preparation - Get context before reviewing PRs
- Architecture Analysis - Understand project organization patterns
- Dependency Auditing - Identify package managers and dependency files
- Open Source Exploration - Study popular repositories without downloading
- Best Practices - Learn from well-structured projects
- Technology Research - Discover how different tools are organized
# Optional: GitHub Personal Access Token for higher API limits
export GITHUB_TOKEN=your_personal_access_token- Unauthenticated: 60 requests/hour
- Authenticated: 5,000 requests/hour
Git Seer works seamlessly without any configuration, but adding a GitHub Personal Access Token dramatically improves your experience by increasing API rate limits from 60 to 5,000 requests per hour.
# Set your GitHub token (optional but recommended)
export GITHUB_TOKEN=your_personal_access_tokenTo enable token authentication, you need to modify both seer.py and seer-tui.py. Here are the required changes:
Step 1: Add import at the top of both files
import os # Add this import if not already presentStep 2: Update the request functions in seer.py
Current Code (Anonymous):
def get_repo_metadata(repo_owner: str, repo_name: str) -> dict | None:
api_url = f"https://api.github.com/repos/{repo_owner}/{repo_name}"
try:
response = requests.get(api_url) # ← No authentication
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException:
return NoneUpdated Code (With Token Support):
def get_repo_metadata(repo_owner: str, repo_name: str) -> dict | None:
api_url = f"https://api.github.com/repos/{repo_owner}/{repo_name}"
# Check for GitHub token and set up headers
token = os.getenv("GITHUB_TOKEN")
headers = {}
if token:
headers["Authorization"] = f"token {token}"
try:
response = requests.get(api_url, headers=headers) # ← Now with auth
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException:
return NoneStep 3: Update the get_repo_tree function in seer.py
Current Code:
def get_repo_tree(repo_owner: str, repo_name: str, branch: str = "main") -> list | None:
api_url = f"https://api.github.com/repos/{repo_owner}/{repo_name}/git/trees/{branch}?recursive=1"
try:
response = requests.get(api_url) # ← No authentication
# ... rest of functionUpdated Code:
def get_repo_tree(repo_owner: str, repo_name: str, branch: str = "main") -> list | None:
api_url = f"https://api.github.com/repos/{repo_owner}/{repo_name}/git/trees/{branch}?recursive=1"
# Check for GitHub token and set up headers
token = os.getenv("GITHUB_TOKEN")
headers = {}
if token:
headers["Authorization"] = f"token {token}"
try:
response = requests.get(api_url, headers=headers) # ← Now with auth
8000
# ... rest of function remains the sameStep 4: Update the get_tree function in seer-tui.py
Current Code:
def get_tree(branch: str = "main") -> list | None:
api_url = f"https://api.github.com/repos/{owner}/{name}/git/trees/{branch}?recursive=1"
try:
response = requests.get(api_url, timeout=10) # ← No authentication
# ... rest of functionUpdated Code:
def get_tree(branch: str = "main") -> list | None:
api_url = f"https://api.github.com/repos/{owner}/{name}/git/trees/{branch}?recursive=1"
# Check for GitHub token and set up headers
token = os.getenv("GITHUB_TOKEN")
headers = {}
if token:
headers["Authorization"] = f"token {token}"
try:
response = requests.get(api_url, headers=headers, timeout=10) # ← Now with auth
# ... rest of function remains the sameThe requests.get() function sends standard HTTP requests with no inherent knowledge of GitHub's authentication system:
Without Token (Anonymous Requests):
- GitHub API receives unauthenticated request
- Counts against public rate limit (60 requests/hour per IP)
- ⚡ Analysis Capacity: ~30-60 repositories/hour
With Token (Authenticated Requests):
- Authorization header identifies you to GitHub API
- Counts against your personal rate limit (5,000 requests/hour)
- 🚀 Analysis Capacity: ~2,500-5,000 repositories/hour
Each Git Seer analysis makes 1-2 API calls per repository:
- 1 call for repository metadata (stars, forks, description)
- 1 call for complete file tree structure
| Authentication | Rate Limit | Repos/Hour | Use Case |
|---|---|---|---|
| None | 60 requests/hour | 30-60 repos | Quick checks, demos |
| Token | 5,000 requests/hour | 2,500-5,000 repos | Development, batch analysis |
-
Go to GitHub Settings → Personal Access Tokens
-
Click "Generate new token" → Choose "Personal access tokens (classic)"
-
Set Token Name:
git-seer-cli -
Select Scopes:
- ✅
public_repo(for public repository access) - ✅
repo(only if you need private repository access)
- ✅
-
Generate Token and copy it immediately
-
Set Environment Variable:
# Linux/macOS
echo 'export GITHUB_TOKEN=your_token_here' >> ~/.bashrc
source ~/.bashrc
# Windows PowerShell
$env:GITHUB_TOKEN="your_token_here"
# Windows Command Prompt
set GITHUB_TOKEN=your_token_here- 🔐 Never commit tokens to version control
- 🔄 Rotate tokens regularly (every 6-12 months)
- 📝 Use minimal scopes required for your use case
- 🗑️ Delete unused tokens from GitHub settings
- 💾 Store securely using environment variables or secret managers
- 📈 Commit Analysis - Activity patterns and contributor insights
- 🔄 Real-time Updates - Live repository monitoring
- 💾 Caching Layer - Local storage for faster repeated analysis
- 🌐 Web Interface - Browser-based repository explorer
- 📊 Export Options - JSON, CSV, and PDF report generation
- 🔒 Private Repository Support - GitHub token integration
We welcome contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create a feature branch
- ✍️ Make your changes
- ✅ Add tests if applicable
- 📤 Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- 🎨 Rich - For beautiful terminal formatting
- 🖥️ Textual - For powerful TUI capabilities
- ⚡ Typer - For elegant CLI interfaces
- 🐙 GitHub API - For making repository data accessible
⭐ Star this repository if you find it useful!
Built with ❤️ for the developer community