Skip to content

bismarkhenao/forkaway

Repository files navigation

Forkaway 🧹

A CLI tool to help you clean up your GitHub fork repositories efficiently.

Features ✨

  • 🔍 List all your fork repositories
  • 🗑️ Delete multiple forks at once
  • ✅ Interactive selection with visual feedback
  • 📊 Progress tracking with status bars
  • 🎯 Bulk or selective deletion options
  • 🔒 Secure GitHub token handling
  • 💫 Beautiful CLI interface

Prerequisites 📋

  • Node.js (v18 or higher)
  • GitHub Personal Access Token (will be prompted during first run)

Installation 🚀

Option 1: Using npm (recommended)

npm install -g forkaway

Option 2: Using curl (universal install)

curl -o- https://raw.githubusercontent.com/bismarkhenao/forkaway/main/install.sh | bash

or using wget:

wget -qO- https://raw.githubusercontent.com/bismarkhenao/forkaway/main/install.sh | bash

Setup 🔧

  1. Generate a GitHub token at https://github.com/settings/tokens

  2. Enable these permissions:

    • repo (Full control of private repositories)
    • delete_repo (Delete repositories)
  3. Add the token to your shell configuration:

    For zsh:

    echo 'export GITHUB_TOKEN=your_token' >> ~/.zshrc
    source ~/.zshrc

    For bash:

    echo 'export GITHUB_TOKEN=your_token' >> ~/.bashrc
    source ~/.bashrc

Usage 💻

Simply run:

forkaway

The interactive CLI will guide you through:

  1. Scanning your GitHub account for forks
  2. Choosing between:
    • Deleting all forks (with safety confirmations)
    • Selecting specific forks to delete
  3. Reviewing selected repositories
  4. Confirming and executing deletions with progress tracking

Visual Feedback 📊

  • Progress bars show deletion status
  • Spinners indicate active operations
  • Color-coded success/failure messages
  • Detailed error reporting
  • Operation summary at completion

Safety Features 🛡️

  • Multiple confirmations for bulk deletions
  • Review step before final deletion
  • Clear error messages
  • Ability to cancel at any point

Contributing 🤝

We welcome contributions! Please see our Contributing Guide for detailed instructions on how to:

  • Set up your development environment
  • Make changes
  • Run tests
  • Submit pull requests
  • Follow our coding standards

License 📄

MIT

Support 💪

If you encounter any issues or have questions:

Packages

 
 
 

Contributors