yeett

A fun little CLI that yeets your scattered project folders into one archive. Move, restore, list, and manage old side-projects with a single word.

The command you type is yeet. Works on Windows, macOS, and Linux. Zero dependencies.

Install

npm install -g yeett

First run

Pick where your archive lives. Nothing moves until you set this:

yeet change "C:\Users\you\Desktop\all_projects"

On macOS/Linux:

yeet change "~/projects/archive"

Usage

cd into any project folder and yeet it away:

yeet                       move current folder into the archive
yeet rename "cool name"    move current folder, renamed
yeet "C:\some\path"        move a specific folder
yeet unyeet "name"         pull a project back into the current folder

Managing

yeet list                  show archived projects
yeet size                  list archived projects by disk usage
yeet open "name"           open a project in your file manager
yeet del "name"            delete one project (asks to confirm)
yeet clear                 delete ALL projects (double confirm)
yeet change "path"         set which folder is your archive

Uninstalling

yeet itself                uninstall yeet + delete all its files
yeet itself full purge     same, plus remove its registry entry

yeet itself does what a plain npm uninstall -g yeett can't: it removes the npm package, deletes yeet's own ~/.yeett folder (config + shell wrapper), and strips yeet's doskey entry from the cmd.exe AutoRun registry value. That last part matters - leaving it behind points every new cmd window at a wrapper that no longer exists ("The system cannot find the path specified"). If you have other commands in AutoRun, they're kept; only yeet's entry is removed.

yeet itself full purge does the same, plus a sweep of the machine-wide (HKLM) AutoRun value for any yeet leftover (that hive may need an elevated shell to write). Both commands ask you to type yes first and only ever touch yeet-owned locations.

Fun

yeet dance                 ASCII dog dance party
yeet flex                  brag about your archive stats
yeet roll                  roll 3 emojis, win tokens
yeet token                 show how many tokens you have

Type yeet help anytime to see the full list.

Auto cd + cleanup (optional)

When you yeet the folder your shell is currently sitting in, Windows locks that folder because your shell's working directory is inside it. yeet archives everything, but the now-empty top folder can't be removed and your shell is left in a folder that's gone. A small shell wrapper fixes this: it runs inside your shell, so after archiving it can move your shell into the archive and delete the empty leftover for you.

Set it up once for the shell you use.

PowerShell

yeet shell-init >> $PROFILE
. $PROFILE

New terminals load it automatically. Verify with (Get-Command yeet).CommandType (should say Function).

cmd.exe

yeet shell-init --cmd

This writes a wrapper to ~/.yeett/yeet-wrapper.cmd and prints two steps:

1. Enable it in the current window:

   doskey yeet="%USERPROFILE%\.yeett\yeet-wrapper.cmd" $*

2. Load it in every new cmd window (registers Command Processor AutoRun):

   reg add "HKCU\Software\Microsoft\Command Processor" /v AutoRun /d "doskey yeet=\"%USERPROFILE%\.yeett\yeet-wrapper.cmd\" $*" /f

   AutoRun runs for every cmd session, so if you already use it, that command overwrites the existing value. Check first with:

   reg query "HKCU\Software\Microsoft\Command Processor" /v AutoRun

After setup, yeet from inside any folder archives it, drops you into the archive, and clears the empty folder - no manual cd .. / rmdir needed.

How it works

• Moves are done with a fast rename on the same volume, falling back to copy + delete across volumes.
• Names never collide: if a folder already exists in the archive, -1, -2, ... is appended.
• Guards refuse to move a filesystem root or the archive itself.
• Deletes only ever touch folders directly inside your archive.
• Config lives in ~/.yeett/config.json (your home directory), created on first yeet change.

License

MIT