REPO-COMMANDS

Powerful Command Line Tools for Repository Management

Built with the tools and technologies:

---

Table of Contents

• Overview
• Getting Started
  • Prerequisites
  • Installation
  • Usage

---

Overview

repo-commands is a collection of powerful command-line tools designed to streamline repository management tasks. Built with PowerShell and Windows compatibility in mind, it provides a robust set of utilities for developers working in Windows environments.

Why repo-commands?

This project enhances developer productivity with the following features:

• ⚡ Fast Command Execution: Quick access to common repository operations through simple commands.
• 🛠️ Windows Integration: Seamlessly integrates with Windows PowerShell environment.
• 📦 Easy Setup: Simple path configuration for immediate use.
• 🔄 Repository Management: Streamlined commands for common Git operations.

---

Getting Started

Prerequisites

This project requires the following:

• Operating System: Windows 10 or later
• Shell: PowerShell

Installation

Add repo-commands to your system path:

$Env:Path += ";C:\path\repo-commands"

Usage

After installation, you can use the commands directly from your PowerShell terminal. The commands will be available system-wide once the path is properly configured.

Available Commands

repo-commands provides a set of powerful commands to streamline your repository management workflow. Here are all available commands and their usage:

Basic Commands

• repo -new "project-name"

  Creates a new React project with the specified project name, setting up a modern development environment.

  repo -new "my-awesome-project"

• repo -clone "repository-url" or "username/repository-name"

  Clones a repository from GitHub. Supports both full URLs and shorthand username/repository-name format.

  repo -clone "https://github.com/username/repository.git"
  # or using shorthand
  repo -clone "username/repository-name"

Repository Management

Note: The following commands must be executed from within your project folder.

• repo -edit

  Optimizes your repository structure by cleaning unnecessary files and creating a well-organized folder structure for better project management. Must be run from within the project directory.

  cd my-awesome-project
  repo -edit

• repo -commit "message"

  Creates a new commit with the specified message, saving your changes to the local repository. Must be run from within the project directory.

  cd my-awesome-project
  repo -commit "Add new feature"

• repo -push

  Uploads your local changes to your GitHub profile, making them available in the remote repository. Must be run from within the project directory.

  cd my-awesome-project
  repo -push

• repo -sync "optional commit message"

  Synchronizes your local repository with the remote repository, pulling any new changes and optionally creating a commit to merge these changes. Must be run from within the project directory.

  cd my-awesome-project
  repo -sync "Sync with remote changes"

Command Examples

Here are some common workflows using these commands:

1. Starting a new project:

   repo -new "my-project"
   repo -edit
   repo -commit "Initial commit"
   repo -push

2. Working with an existing project:

   repo -clone "https://github.com/username/repo.git"
   repo -edit
   repo -commit "Update documentation"
   repo -push

3. Keeping your repository up to date:

   repo -sync "Merge remote changes"

Each command is designed to be simple and intuitive, making repository management tasks more efficient and less error-prone.