gitaura/README.md

Tool to create backdated git commits for GitHub contribution graph

# GitAura

A command-line tool that helps you create backdated git commits and populate your GitHub contribution graph.

## Features

- Create a new GitHub repository or use an existing one
- Generate multiple backdated commits across any date range
- Evenly distribute commits throughout the selected period
- Automatically push commits to GitHub

## Usage

Run directly with npx:

```bash
npx gitaura
```

The tool will:
1. Ask where you want to create your repository (defaults to ~/gitaura)
2. Create the directory if it doesn't exist
3. Set up a Git repository via GitHub
4. Create backdated commits based on your specified date range
5. Push the commits to GitHub

Don't worry–it will not do anything without your confirmation.

## Requirements

- Node.js
- Git installed locally
- GitHub CLI (gh) installed for easier repository creation (optional)