New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details
Socket
Book a DemoSign in
Socket

git-bro

Package Overview
Dependencies
Maintainers
2
Versions
13
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

git-bro

CLI tool that lets you download specific folders from GitHub repositories without cloning the entire repo.

latest
Source
npmnpm
Version
1.2.4
Version published
Maintainers
2
Created
Source

git-bro

NPM version License: MIT Downloads GitHub issues GitHub stars

Get detailed insights for GitHub repositories without cloning the entire codebase

InstallationUsageFeaturesExamplesConfigurationTroubleshootingContributingLicense

Why git-bro?

Have you ever needed detailed insights for a GitHub repository? Or wanted to audit dependencies, explore commit history, or analyze project metadata without downloading the entire codebase? git-bro solves these problems by providing specific commands to generate insights, audit dependencies, explore commits, and generate project folder structures, saving you bandwidth, time, and disk space.

Features

  • Generate Insights: Get detailed insights for a GitHub repository
  • Audit Dependencies: Analyze dependencies in a GitHub repository
  • Explore Commits: View commit history of a GitHub repository
  • Generate Structure: Generate a project folder structure

Installation

npm install -g git-bro

This installs git-bro as a global command-line tool accessible from anywhere in your terminal.

On-demand Usage

npx git-bro <github-repo-url>

Run git-bro directly without installation using npx.

Command Line Options

OptionDescription
-V, --versionShow version number
-h, --helpShow help

Commands

CommandDescription
insights <repo> [options] Generate detailed insights for a GitHub repository
audit <repo> [options] Audit dependencies in a GitHub repository
commits <repo> [options]Explore commit history of a GitHub repository
generateGenerate a project folder structure

Commits Feature Options

OptionDescription
-a, --author <author>Filter commits by author
-f, --file <file>Filter commits by file path
-c, --conflictsShow only commits with merge conflicts
-l, --limit <number>Limit number of commits (default: "50")
-h, --helpDisplay help for command

Audit Feature Options

OptionDescription
--type <type>Type of dependency file (package.json, requirements.txt)
--output <path>Output directory for audit reports

Examples

Generate Insights for a Repository

git-bro insights username/repository

Audit Dependencies in a Repository

git-bro audit username/repository

Explore Commit History

git-bro commits username/repository

Generate Project Folder Structure

git-bro generate

Configuration

git-bro works out of the box without configuration. For rate-limited GitHub API usage, authentication support is under development.

Troubleshooting

Common Issues

Rate Limit Exceeded

Error: Request failed with status code 403

Solution: GitHub limits unauthenticated API requests. Wait a few minutes and try again.

Invalid URL Format

Error: Invalid GitHub URL format

Solution: Ensure your URL follows the pattern: https://github.com/owner/repo

Repository Not Found

Error: Repository not found

Solution: Verify the repository name and ensure it is accessible.

Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions to git-bro are greatly appreciated.

  • Fork the repository
  • Create your feature branch (git checkout -b feature/amazing-feature)
  • Commit your changes (git commit -m 'Add some amazing feature')
  • Push to the branch (git push origin feature/amazing-feature)
  • Open a Pull Request

See the open issues for a list of proposed features and known issues.

Roadmap

  • Add GitHub token authentication
  • Support for GitLab and Bitbucket repositories
  • Download from specific commits or tags
  • Dry run mode
  • CLI interactive mode

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • GitHub API for making this tool possible
  • Everyone who has provided feedback and suggestions

Made with ❤️ by Adwait-Borate and ShreyashIngle

If you find this tool useful, consider sponsoring its development

Keywords

git

FAQs

Package last updated on 29 Jun 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts