A simple Python CLI multitool for performing GitHub repository reconnaissance and OSINT.
Create a virtual environment with:
python -m venv .venvActivate the virtual environment with:
# Windows
.venv\Scripts\activate
# Linux / macOS
source .venv/bin/activateInstall the requirements with:
pip install -r requirements.txtCreate a .env file in the project directory and add your GitHub API token:
GITHUB_API_TOKEN=your_token_here
Run the program with:
python main.pyA menu will appear allowing you to select the tool you want to use.
pip install -r requirements.txtGit must also be installed and available in your PATH.
A GitHub API token is required for the repository metadata and user graphing tools.
RepoRecon/
├── LICENSE
├── README.md
├── docs/
│ ├── misc/
│ │ └── username_search.md
│ ├── misc_tools.md
│ ├── repo/
│ │ ├── metadata_viewer.md
│ │ └── repo_audit.md
│ ├── repo_tools.md
│ ├── user/
│ │ ├── mutuals_grapher.md
│ │ └── relationship_grapher.md
│ └── user_tools.md
├── main.py
├── requirements.txt
├── sites.txt
└── tools/
├── misc/
│ └── username_search.py
├── repo/
│ ├── metadata_viewer.py
│ └── repo_audit.py
├── user/
│ ├── mutuals_grapher.py
│ └── relationship_grapher.py
└── utils/
└── _clear_terminal.py
The .env file should not be committed to the repository.
Interactive graph results are saved to the outputs/ directory as HTML files.
This tool is intended for educational purposes and legitimate OSINT research. Only use RepoRecon against repositories, accounts and information that you are authorised to investigate.