@lakshanmuruganandam/git-time-machine 1.0.8

package/README.md

@@ -0,0 +1,67 @@
+<div align="center">
+
+# ⏳ Git Time Machine
+
+> **Interactively travel between your recent Git branches with a beautiful UI.**
+
+[![npm version](https://badge.fury.io/js/git-time-machine.svg)](https://www.npmjs.com/package/git-time-machine)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+```text
+    ██████╗ ██╗████████╗    ████████╗██╗███╗   ███╗███████╗
+    ██╔════╝ ██║╚══██╔══╝    ╚══██╔══╝██║████╗ ████║██╔════╝
+    ██║  ███╗██║   ██║          ██║   ██║██╔████╔██║█████╗  
+    ██║   ██║██║   ██║          ██║   ██║██║╚██╔╝██║██╔══╝  
+    ╚██████╔╝██║   ██║          ██║   ██║██║ ╚═╝ ██║███████╗
+     ╚═════╝ ╚═╝   ╚═╝          ╚═╝   ╚═╝╚═╝     ╚═╝╚══════╝
+    ███╗   ███╗ █████╗  ██████╗ ██╗  ██╗██╗███╗   ██╗███████╗
+    ████╗ ████║██╔══██╗██╔════╝ ██║  ██║██║████╗  ██║██╔════╝
+    ██╔████╔██║███████║██║      ███████║██║██╔██╗ ██║█████╗  
+    ██║╚██╔╝██║██╔══██║██║      ██╔══██║██║██║╚██╗██║██╔══╝  
+    ██║ ╚═╝ ██║██║  ██║╚██████╗ ██║  ██║██║██║ ╚████║███████╗
+    ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝
+```
+
+Typing `git branch`, hunting for the branch you worked on yesterday, and then manually typing `git checkout ...` is a massive waste of time.
+
+**Git Time Machine** completely reinvents your git workflow by giving you a beautiful, interactive list of your local branches, sorted chronologically by the last commit date, allowing you to seamlessly "time jump" to your desired branch.
+
+## ✨ Features
+
+- **🕒 Chronological Sorting:** Branches are automatically sorted so the ones you were just working on are at the very top.
+- **📝 Context Aware:** Shows the last commit message and the exact time it was committed so you never forget what a branch was for.
+- **⚡ Lightning Fast:** No typing required. Just use your arrow keys and hit Enter to travel.
+- **🎨 Premium UX:** Built with `inquirer` for a buttery-smooth terminal experience, complete with custom ASCII art.
+
+## 🚀 Installation
+
+Run it instantly anywhere without installing:
+
+```bash
+npx git-time-machine
+```
+
+Or install it globally to keep the time machine on your terminal dashboard:
+
+```bash
+npm install -g git-time-machine
+```
+
+## 🎮 Usage
+
+Run the command inside any git repository:
+
+```bash
+git-time-machine
+```
+
+### Controls:
+- **`↑ / ↓`** : Scroll through the timeline.
+- **`Enter`** : Initiate the time jump.
+
+---
+
+### Architected by [@lakshanmuruganandam](https://github.com/lakshanmuruganandam)
+*Because we shouldn't have to remember exact branch names in 2026.*

package/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+import { execSync } from 'child_process';
+import inquirer from 'inquirer';
+import pc from 'picocolors';
+import { Command } from 'commander';
+import boxen from 'boxen';
+
+const program = new Command();
+
+program
+  .name('git-time-machine')
+  .description('Interactively travel between your recent Git branches with a beautiful UI.')
+  .version('1.0.0')
+  .parse(process.argv);
+
+const banner = `
+    ██████╗ ██╗████████╗    ████████╗██╗███╗   ███╗███████╗
+    ██╔════╝ ██║╚══██╔══╝    ╚══██╔══╝██║████╗ ████║██╔════╝
+    ██║  ███╗██║   ██║          ██║   ██║██╔████╔██║█████╗  
+    ██║   ██║██║   ██║          ██║   ██║██║╚██╔╝██║██╔══╝  
+    ╚██████╔╝██║   ██║          ██║   ██║██║ ╚═╝ ██║███████╗
+     ╚═════╝ ╚═╝   ╚═╝          ╚═╝   ╚═╝╚═╝     ╚═╝╚══════╝
+    ███╗   ███╗ █████╗  ██████╗ ██╗  ██╗██╗███╗   ██╗███████╗
+    ████╗ ████║██╔══██╗██╔════╝ ██║  ██║██║████╗  ██║██╔════╝
+    ██╔████╔██║███████║██║      ███████║██║██╔██╗ ██║█████╗  
+    ██║╚██╔╝██║██╔══██║██║      ██╔══██║██║██║╚██╗██║██╔══╝  
+    ██║ ╚═╝ ██║██║  ██║╚██████╗ ██║  ██║██║██║ ╚████║███████╗
+    ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝╚══════╝
+`;
+
+console.log(pc.magenta(banner));
+console.log(pc.gray('    Where are we going today?'));
+console.log(pc.dim('    Architected by @lakshanmuruganandam\n'));
+
+try {
+  // Check if we are in a git repo
+  execSync('git rev-parse --is-inside-work-tree', { stdio: 'ignore' });
+} catch (e) {
+  console.log(pc.red('❌ You are not inside a Git repository. Exiting.'));
+  process.exit(1);
+}
+
+try {
+  const currentBranch = execSync('git branch --show-current').toString().trim();
+  const rawBranches = execSync('git for-each-ref --sort=-committerdate refs/heads/ --format="%(refname:short)|%(committerdate:relative)|%(authorname)|%(subject)"').toString().trim();
+  
+  if (!rawBranches) {
+    console.log(pc.green('✨ Your repository is completely empty. No branches found.'));
+    process.exit(0);
+  }
+
+  const branches = rawBranches.split('\n').map(line => {
+    const [name, date, author, subject] = line.split('|');
+    return { name: name?.trim(), date: date?.trim(), author: author?.trim(), subject: subject?.trim() };
+  }).filter(b => b.name && b.name !== currentBranch);
+
+  if (branches.length === 0) {
+    console.log(pc.green(`✨ You only have the current branch (${currentBranch}). Nowhere to travel to.`));
+    process.exit(0);
+  }
+
+  const choices = branches.map(b => {
+    let dateColored = pc.gray(b.date);
+    if (b.date.includes('minutes') || b.date.includes('hours')) {
+      dateColored = pc.green(b.date);
+    } else if (b.date.includes('days')) {
+      dateColored = pc.yellow(b.date);
+    }
+
+    // Truncate subject if too long
+    let shortSubject = b.subject || '';
+    if (shortSubject.length > 40) shortSubject = shortSubject.substring(0, 37) + '...';
+
+    return {
+      name: `${b.name.padEnd(25)} 🕒 ${dateColored.padEnd(25)} 📝 ${pc.gray(shortSubject)}`,
+      value: b.name,
+      short: b.name
+    };
+  });
+
+  const { selected } = await inquirer.prompt([{
+    type: 'list',
+    name: 'selected',
+    message: `Select a timeline to travel to (Current: ${pc.cyan(currentBranch)}):`,
+    choices: choices,
+    pageSize: 12,
+    loop: false
+  }]);
+
+  console.log();
+  try {
+    const output = execSync(`git checkout ${selected}`, { encoding: 'utf-8', stdio: 'pipe' });
+    console.log(
+      boxen(
+        pc.green(`Time jump successful. 🌌\n`) + pc.white(`You are now in: ${pc.bold(selected)}`),
+        { padding: 1, margin: { top: 1 }, borderStyle: 'round', borderColor: 'green' }
+      )
+    );
+  } catch (e) {
+    console.log(pc.red(`❌ Failed to travel to timeline: `) + pc.white(selected));
+    if (e.stderr) console.log(pc.gray(e.stderr.toString()));
+  }
+
+} catch (error) {
+  console.error(pc.red('\nAn unexpected error occurred:'), error.message);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@lakshanmuruganandam/git-time-machine",
+  "version": "1.0.8",
+  "description": "Interactively travel between your recent Git branches with a beautiful UI.",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "git",
+    "branch",
+    "checkout",
+    "cli",
+    "time-machine",
+    "interactive"
+  ],
+  "author": "Lakshan Muruganandam <lakshan@example.com>",
+  "license": "MIT",
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "cli-spinners": "^3.4.0",
+    "commander": "^15.0.0",
+    "inquirer": "^8.2.6",
+    "log-update": "^8.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "bin": {
+    "git-time-machine": "./index.js"
+  },
+  "type": "module"
+}