RepoLauncher

RepoLauncher is a productivity tool designed to streamline the process of initializing, creating, and pushing local Git repositories to GitHub. It automates the tedious steps of setting up a new project, allowing you to focus on coding.

Features

• Automatic Git Initialization: Checks if a Git repository exists and initializes one if needed.
• GitHub Repository Creation: Automatically creates a repository on GitHub using your Personal Access Token.
  • Supports creating both Public and Private repositories.
  • Handles existing repositories gracefully.
• Smart Push: Automatically adds a remote origin and pushes your current branch (detects main, master, etc.) to GitHub.
• Path Support: Can be run from anywhere to target a specific project directory.
• Dependency Management: Built with uv for fast and reliable Python package management.

Prerequisites

• Python 3.12+
• uv (An extremely fast Python package installer and resolver)
• A GitHub Personal Access Token (Classic) with repo permissions.

Setup

1. Clone or Download this repository.
2. Install Dependencies:

   uv sync

3. Configure Environment:
   • Copy .env.example to .env:

     cp .env.example .env

     (On Windows: copy .env.example .env)
   • Open .env and paste your GitHub Personal Access Token:

     GITHUB_TOKEN=ghp_your_token_here

Usage

Run the tool using uv run:

1. Process the Current Directory

uv run main.py

2. Process a Specific Directory

uv run main.py /path/to/your/project

3. Create a Private Repository

uv run main.py /path/to/your/project --private

How it Works

1. Scans the target directory.
2. Initializes git if not already present.
3. Creates a repository on GitHub with the same name as the directory.
4. Links the local repository to the remote GitHub repository.
5. Commits any uncommitted changes (with a default message).
6. Pushes the current branch to GitHub.

License

MIT