githate 1.0.0

package/README.md

@@ -0,0 +1,105 @@
+# GitHate CLI 🕵️‍♂️
+
+**Track who unfollowed you on GitHub directly from your terminal.**
+
+`githate` is a modern, fast, and beautiful CLI tool that helps you keep track of your GitHub followers. It detects who unfollowed you since the last check and lets you manage your following list with ease.
+
+![GitHate CLI Demo](https://placehold.co/600x400?text=GitHate+CLI+Demo)
+
+## Features
+
+- 🕵️ **Track Unfollowers**: Instantly see who stopped following you.
+- 📈 **Track New Followers**: See who started following you.
+- 👥 **Manage Relationships**: List followers, following, and follow/unfollow users.
+- 🔐 **Secure**: Your Personal Access Token is stored locally on your machine.
+- 💅 **Beautiful UI**: Built with `@clack/prompts` and `picocolors` for a great experience.
+
+## Installation
+
+You can install `githate` globally using npm:
+
+```bash
+npm install -g githate
+```
+
+_Note: You may need to use `sudo` on macOS/Linux if you have permission issues._
+
+## Setup
+
+1.  **Generate a GitHub Personal Access Token (PAT)**:
+    - Go to [GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)](https://github.com/settings/tokens).
+    - Click **Generate new token (classic)**.
+    - Give it a note (e.g., "GitHate CLI").
+    - Select the **`read:user`** and **`user:follow`** scopes.
+    - Click **Generate token** and copy it.
+
+2.  **Login**:
+    Run the login command and paste your token when prompted:
+    ```bash
+    githate login
+    ```
+
+## Usage
+
+### Check for Haters (Unfollowers)
+
+This is the main feature. Run this command to compare your current followers with the last saved state.
+
+```bash
+githate check
+```
+
+_On the first run, it will just save your current followers._
+
+### List Followers
+
+```bash
+githate followers
+```
+
+### List Following
+
+```bash
+githate following
+```
+
+### Follow a User
+
+```bash
+githate follow <username>
+```
+
+### Unfollow a User
+
+```bash
+githate unfollow <username>
+```
+
+## Automation (Daily Check)
+
+You can set up a cron job or task scheduler to run `githate check` daily.
+
+### macOS / Linux (Cron)
+
+1.  Open your crontab:
+    ```bash
+    crontab -e
+    ```
+2.  Add the following line to run everyday at 9 AM:
+    ```bash
+    0 9 * * * /usr/local/bin/githate check >> /tmp/githate.log 2>&1
+    ```
+    _(Make sure to use the correct path to `githate`. You can find it with `which githate`)_
+
+### Windows (Task Scheduler)
+
+1.  Open **Task Scheduler**.
+2.  Create a Basic Task.
+3.  Set the trigger to **Daily**.
+4.  Set the action to **Start a program**.
+5.  Program/script: `githate` (or full path to `githate.cmd`).
+6.  Add arguments: `check`.
+
+## License
+
+ISC

package/bin/hater.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(
+  readFileSync(join(__dirname, "../package.json"), "utf-8"),
+);
+
+const program = new Command();
+
+program
+  .name("githate")
+  .description("Track who unfollowed you on GitHub")
+  .version(pkg.version);
+
+program
+  .command("login")
+  .description("Login to GitHub with a Personal Access Token")
+  .action(async () => {
+    const { login } = await import("../lib/commands/login.js");
+    await login();
+  });
+
+program
+  .command("check")
+  .description("Check for new unfollowers")
+  .action(async () => {
+    const { check } = await import("../lib/commands/check.js");
+    await check();
+  });
+
+program
+  .command("followers")
+  .description("List your followers")
+  .action(async () => {
+    const { followers } = await import("../lib/commands/followers.js");
+    await followers();
+  });
+
+program
+  .command("following")
+  .description("List who you are following")
+  .action(async () => {
+    const { following } = await import("../lib/commands/following.js");
+    await following();
+  });
+
+program
+  .command("follow <username>")
+  .description("Follow a user")
+  .action(async (username) => {
+    const { follow } = await import("../lib/commands/follow.js");
+    await follow(username);
+  });
+
+program
+  .command("unfollow <username>")
+  .description("Unfollow a user")
+  .action(async (username) => {
+    const { unfollow } = await import("../lib/commands/unfollow.js");
+    await unfollow(username);
+  });
+
+program.parse(process.argv);

package/lib/commands/check.js

@@ -0,0 +1,98 @@
+import { getOctokit } from "../utils/auth.js";
+import {
+  getStoredFollowers,
+  setStoredFollowers,
+  setLastCheck,
+  getLastCheck,
+} from "../utils/store.js";
+import {
+  displayIntro,
+  displaySuccess,
+  displayError,
+  createSpinner,
+  displayInfo,
+  displayWarning,
+  displayOutro,
+} from "../ui/display.js";
+import color from "picocolors";
+
+export const check = async () => {
+  displayIntro();
+  const s = createSpinner();
+
+  try {
+    const octokit = getOctokit();
+    s.start("Fetching current followers...");
+
+    const currentFollowers = await octokit.paginate(
+      octokit.rest.users.listFollowersForAuthenticatedUser,
+      {
+        per_page: 100,
+      },
+    );
+    const currentFollowerLogins = currentFollowers.map((f) => f.login);
+
+    s.stop("Followers fetched");
+
+    const storedFollowers = getStoredFollowers();
+    const lastCheck = getLastCheck();
+
+    if (storedFollowers.length === 0) {
+      displayInfo(
+        "First run detected! Storing current followers for future checks.",
+      );
+      setStoredFollowers(currentFollowerLogins);
+      setLastCheck(new Date().toISOString());
+      displayOutro(`Tracking ${currentFollowerLogins.length} followers.`);
+      return;
+    }
+
+    // Find new followers
+    const newFollowers = currentFollowerLogins.filter(
+      (login) => !storedFollowers.includes(login),
+    );
+
+    // Find unfollowers (The Haters)
+    const unfollowers = storedFollowers.filter(
+      (login) => !currentFollowerLogins.includes(login),
+    );
+
+    console.log("");
+    if (lastCheck) {
+      displayInfo(`Last check: ${new Date(lastCheck).toLocaleString()}`);
+    }
+    console.log("");
+
+    if (newFollowers.length > 0) {
+      displaySuccess(`New Followers (+${newFollowers.length}):`);
+      newFollowers.forEach((login) =>
+        console.log(` ${color.green("+")} ${login}`),
+      );
+      console.log("");
+    } else {
+      console.log(color.dim("No new followers."));
+    }
+
+    if (unfollowers.length > 0) {
+      displayWarning(`Unfollowers (-${unfollowers.length}):`); // Using warning for "haters"
+      unfollowers.forEach((login) =>
+        console.log(` ${color.red("-")} ${login}`),
+      );
+      console.log("");
+      displayInfo(
+        'Consider using "hater unfollow <username>" if you want to respond.',
+      );
+    } else {
+      console.log(color.dim("No new unfollowers. Everyone still loves you!"));
+    }
+
+    // Update store
+    setStoredFollowers(currentFollowerLogins);
+    setLastCheck(new Date().toISOString());
+
+    displayOutro("Check complete & database updated.");
+  } catch (error) {
+    s.stop("Check failed");
+    displayError(error.message);
+  }
+};

package/lib/commands/follow.js

@@ -0,0 +1,27 @@
+import { getOctokit } from "../utils/auth.js";
+import {
+  displayIntro,
+  displaySuccess,
+  displayError,
+  createSpinner,
+} from "../ui/display.js";
+
+export const follow = async (username) => {
+  displayIntro();
+  const s = createSpinner();
+
+  try {
+    const octokit = getOctokit();
+    s.start(`Following ${username}...`);
+
+    await octokit.rest.users.follow({
+      username,
+    });
+
+    s.stop(`Followed ${username}`);
+    displaySuccess(`Successfully followed ${username}`);
+  } catch (error) {
+    s.stop(`Failed to follow ${username}`);
+    displayError(error.message);
+  }
+};

package/lib/commands/followers.js

@@ -0,0 +1,43 @@
+import { getOctokit } from "../utils/auth.js";
+import {
+  displayIntro,
+  displayOutro,
+  createSpinner,
+  displayError,
+} from "../ui/display.js";
+import color from "picocolors";
+
+export const followers = async () => {
+  displayIntro();
+  const s = createSpinner();
+
+  try {
+    const octokit = getOctokit();
+    s.start("Fetching followers...");
+
+    const followersList = await octokit.paginate(
+      octokit.rest.users.listFollowersForAuthenticatedUser,
+      {
+        per_page: 100,
+      },
+    );
+
+    s.stop(`Found ${followersList.length} followers`);
+
+    if (followersList.length === 0) {
+      displayOutro("You have no followers yet.");
+      return;
+    }
+
+    console.log(""); // New line
+    followersList.forEach((follower) => {
+      console.log(`${color.green("•")} ${follower.login}`);
+    });
+    console.log("");
+
+    displayOutro("End of followers list");
+  } catch (error) {
+    s.stop("Failed to fetch followers");
+    displayError(error.message);
+  }
+};

package/lib/commands/following.js

@@ -0,0 +1,43 @@
+import { getOctokit } from "../utils/auth.js";
+import {
+  displayIntro,
+  displayOutro,
+  createSpinner,
+  displayError,
+} from "../ui/display.js";
+import color from "picocolors";
+
+export const following = async () => {
+  displayIntro();
+  const s = createSpinner();
+
+  try {
+    const octokit = getOctokit();
+    s.start("Fetching following list...");
+
+    const followingList = await octokit.paginate(
+      octokit.rest.users.listFollowedByAuthenticated,
+      {
+        per_page: 100,
+      },
+    );
+
+    s.stop(`You are following ${followingList.length} users`);
+
+    if (followingList.length === 0) {
+      displayOutro("You are not following anyone.");
+      return;
+    }
+
+    console.log(""); // New line
+    followingList.forEach((user) => {
+      console.log(`${color.blue("•")} ${user.login}`);
+    });
+    console.log("");
+
+    displayOutro("End of following list");
+  } catch (error) {
+    s.stop("Failed to fetch following list");
+    displayError(error.message);
+  }
+};

package/lib/commands/login.js

@@ -0,0 +1,39 @@
+import { password, isCancel, cancel } from "@clack/prompts";
+import { setStoredToken, verifyToken } from "../utils/auth.js";
+import {
+  displayIntro,
+  displaySuccess,
+  displayError,
+  displayOutro,
+  createSpinner,
+} from "../ui/display.js";
+
+export const login = async () => {
+  displayIntro();
+
+  const token = await password({
+    message: "Enter your GitHub Personal Access Token",
+    mask: "*",
+  });
+
+  if (isCancel(token)) {
+    cancel("Login cancelled");
+    process.exit(0);
+  }
+
+  const s = createSpinner();
+  s.start("Verifying token...");
+
+  try {
+    const user = await verifyToken(token);
+    setStoredToken(token);
+    s.stop("Token verified!");
+    displaySuccess(`Logged in as ${user.login}`);
+  } catch (error) {
+    s.stop("Verification failed");
+    displayError(error.message);
+    process.exit(1);
+  }
+
+  displayOutro("You are ready to track the haters!");
+};

package/lib/commands/unfollow.js

@@ -0,0 +1,27 @@
+import { getOctokit } from "../utils/auth.js";
+import {
+  displayIntro,
+  displaySuccess,
+  displayError,
+  createSpinner,
+} from "../ui/display.js";
+
+export const unfollow = async (username) => {
+  displayIntro();
+  const s = createSpinner();
+
+  try {
+    const octokit = getOctokit();
+    s.start(`Unfollowing ${username}...`);
+
+    await octokit.rest.users.unfollow({
+      username,
+    });
+
+    s.stop(`Unfollowed ${username}`);
+    displaySuccess(`Successfully unfollowed ${username}`);
+  } catch (error) {
+    s.stop(`Failed to unfollow ${username}`);
+    displayError(error.message);
+  }
+};

package/lib/ui/display.js

@@ -0,0 +1,30 @@
+import { intro, outro, spinner, note, log } from "@clack/prompts";
+import color from "picocolors";
+
+export const displayIntro = () => {
+  intro(color.bgRed(color.white(" GITHATE CLI ")));
+};
+
+export const displayOutro = (message) => {
+  outro(message);
+};
+
+export const displayError = (message) => {
+  log.error(color.red(message));
+};
+
+export const displaySuccess = (message) => {
+  log.success(color.green(message));
+};
+
+export const displayInfo = (message) => {
+  log.info(color.cyan(message));
+};
+
+export const displayWarning = (message) => {
+  log.warn(color.yellow(message));
+};
+
+export const createSpinner = () => {
+  return spinner();
+};

package/lib/utils/auth.js

@@ -0,0 +1,27 @@
+import { Octokit } from "@octokit/rest";
+import { getStoredToken } from "./store.js";
+import { displayError } from "../ui/display.js";
+
+let octokitInstance = null;
+
+export const getOctokit = () => {
+  if (octokitInstance) return octokitInstance;
+
+  const token = getStoredToken();
+  if (!token) {
+    throw new Error('Not logged in. Run "hater login" first.');
+  }
+
+  octokitInstance = new Octokit({ auth: token });
+  return octokitInstance;
+};
+
+export const verifyToken = async (token) => {
+  try {
+    const octokit = new Octokit({ auth: token });
+    const { data } = await octokit.rest.users.getAuthenticated();
+    return data;
+  } catch (error) {
+    throw new Error("Invalid token or network error.");
+  }
+};

package/lib/utils/store.js

@@ -0,0 +1,32 @@
+import Conf from "conf";
+
+const schema = {
+  token: {
+    type: "string",
+  },
+  followers: {
+    type: "array",
+    default: [],
+  },
+  lastCheck: {
+    type: "string",
+  },
+};
+
+const config = new Conf({
+  projectName: "githate-cli",
+  schema,
+});
+
+export const getStoredToken = () => config.get("token");
+export const setStoredToken = (token) => config.set("token", token);
+export const deleteStoredToken = () => config.delete("token");
+
+export const getStoredFollowers = () => config.get("followers");
+export const setStoredFollowers = (followers) =>
+  config.set("followers", followers);
+
+export const setLastCheck = (date) => config.set("lastCheck", date);
+export const getLastCheck = () => config.get("lastCheck");
+
+export const clearStore = () => config.clear();

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "githate",
+  "version": "1.0.0",
+  "description": "A CLI tool to track who unfollowed you on GitHub.",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "githate": "bin/hater.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "github",
+    "cli",
+    "unfollowers",
+    "tracker"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@octokit/rest": "^20.0.0",
+    "commander": "^14.0.3",
+    "conf": "^15.1.0",
+    "picocolors": "^1.1.1"
+  }
+}