git-recently 🧠

🧠 Instantly see your latest unstaged or untracked Git changes — right from the terminal.

A lightweight and lightning-fast CLI tool to instantly list your most recently modified (unstaged or untracked) files in any Git repository — without extra setup or dependencies.

✅ Requirements

• Git
• Bash-compatible shell
  (Linux, macOS, WSL, or Git Bash on Windows)

🚀 Installation

Run the following command to install git-recently:

curl -fsSL https://raw.githubusercontent.com/barhouum7/git-recently/master/install.sh | bash

Note:

The install script is fully open-source and safe to inspect. You can always download and review it manually:

curl -fsSL https://raw.githubusercontent.com/barhouum7/git-recently/master/install.sh -o install.sh
bash install.sh

It does not require sudo — it only adds a small alias to your local Git configuration.

🔄 Update to latest

Simply re-run the same install command:

curl -fsSL https://raw.githubusercontent.com/barhouum7/git-recently/master/install.sh | bash

🧩 Usage

Run inside any Git repository:

git recent

Example output:

2025-10-30 01:23:04.123456789 +0100 src/components/Navbar.tsx
2025-10-30 01:20:57.789012345 +0100 pages/dashboard.tsx

🧱 How It Works

git-recently does the following under the hood:

1. Detects unstaged and untracked files.
2. Fetches their modification timestamps.
3. Sorts everything newest first.
4. Displays results in a clean, colorized format.

Cross-platform compatible — works seamlessly on Linux, macOS, WSL, and Git Bash.

💬 Why not just use git log --name-status?

Good question. git log is limited to showing changes in committed files. git-recently solves a different problem: tracking your current work-in-progress. It focuses on modified but uncommitted files, helping you instantly recall what you were editing when juggling multiple features or branches.

⚙️ Design Notes

The repo includes small install/uninstall scripts for convenience and clean removal. Fun utilities like figlet or lolcat are optional, purely cosmetic, and not required for core functionality. A Node.js CLI version (npx git-recently) is in the works for users who prefer package-based installation.

💡 Uninstall

curl -fsSL https://raw.githubusercontent.com/barhouum7/git-recently/master/uninstall.sh | bash

# Or simply run:
bash uninstall.sh

📸 Demo

git-recently.Instantly.See.Your.Latest.Unstaged.Untracked.Git.Changes.mp4

🧠 Built With

• Bash
• Git
• stat (Linux/macOS)

🗺️ Roadmap

• Add PowerShell installer (Windows native)

• Port to Node.js for npx git-recently

• Add unit tests and CI workflow

• Add output customization (JSON / plain text)

⚖️ License

MIT 📜 Created with ❤️ by @barhouum7 ↗