repo-notifier 0.1.2

A CLI tool that emails a friend when you create a new GitHub repo

📦 Repo Notifier

A simple Python CLI tool that monitors your GitHub account and sends you an email whenever a new repository is created.

---

✨ Features

• ✅ Detects newly created public repositories
• 📧 Sends email notifications
• 🔐 Uses environment variables for secure credentials
• 🧪 Easy to test and extend
• 💻 Usable from terminal via repo-notifier command

---

📥 Installation

pip install repo-notifier

---

⚙️ Setup

1. Create a .env file in your working directory with the following variables:

GITHUB_USERNAME=your_github_username
GITHUB_TOKEN=your_github_token
SENDER_EMAIL=[e-mail]
APP_PASSWORD=your_gmail_app_password
RECEIVER_EMAIL=[e-mail]

⚠️ Make sure to generate a GitHub Personal Access Token (classic) with repo and read:user scopes.
⚠️ For Gmail, use an App Password (not your actual password).

---

🚀 Usage

Run the tool using:

repo-notifier

If a new repo is detected, you’ll receive an email with a link to the new repository.

---

📂 File Structure

repo-notifier/
├── notifier/
│   ├── __init__.py
│   └── notifier.py
├── .env                  # Your secrets (not committed)
├── README.md
├── setup.py
├── pyproject.toml
└── MANIFEST.in

---

🛠 Example Email

Subject: New GitHub Repo: my-new-project

Hey! 👋

A new GitHub repository was just created:
🔗 https://github.com/your_username/my-new-project

Check it out!

– Your GitHub Notifier Bot

---

📃 License

MIT © 2025 Priyanshu Raj