winbat

Personal Windows CLI toolkit. Clone once, install, done.

cmdx (Unix → Windows generator) · winbat (CLI toolkit) · wcmd (Windows → Linux)

---

Installation

git clone https://github.com/Jeffrey0117/winbat.git C:\dev\winbat
cd C:\dev\winbat
install.bat

Restart terminal. All tools available.

Uninstall

cd C:\dev\winbat
uninstall.bat

---

Tools

Claude Code Shortcuts

Command	Description
cc	Launch Claude Code in current directory (auto-installs if missing)
cdcc <dir>	cd into a directory, then launch Claude Code
clonecc <url> [dir]	git clone a repo, cd into it, then launch Claude Code

Navigation & Filesystem

Command	Description
desk	cd to Desktop
mkcd <dir>	Create a directory and cd into it

System Utilities

Command	Description
ip	Show local IPv4 addresses
ports	Show listening ports with process info
path	Manage user PATH (add / remove / list)

Editor

Command	Description
typee	Editor Abstraction Layer — open files with any editor

Unix Commands (via cmdx)

42 Unix commands that just work on Windows:

ls, cat, cp, mv, rm, pwd, clear, which, touch, grep, head, tail,
find, man, df, ps, kill, killall, top, ifconfig, traceroute, diff,
less, env, printenv, history, ln, reboot, shutdown, uptime, whoami,
hostname, uname, free, du, wget, open, xdg-open, pbcopy, nano, vi, vim

Each command auto-detects better tools (like lsd, bat, rg) and falls back to Windows native if not installed.

---

Usage Examples

Claude Code Shortcuts

cc                                          # launch Claude Code here
cdcc myproject                              # cd + Claude Code
clonecc https://github.com/user/repo.git    # clone + cd + Claude Code
clonecc https://github.com/user/repo mydir  # clone into mydir + cd + Claude Code

Navigation & Filesystem

desk                  # jump to Desktop
mkcd new-project      # create and enter directory

System Utilities

ip                    # show local IPv4 addresses
ports                 # show listening ports
path list             # list user PATH entries
path add C:\mytool    # add directory to PATH
path remove C:\mytool # remove from PATH

Editor

typee file.txt            # type (print)
typee --vs file.txt       # VS Code
typee --cursor file.txt   # Cursor
typee --editors           # list available editors

See typee/README.md for full docs.

Unix Commands

ls                        # uses lsd/eza if installed, else dir
cat file.txt              # uses bat if installed, else type
grep pattern file         # uses rg if installed, else findstr

---

Adding New Tools

1. Create mytool.bat or mytool.cmd in root, or
2. Create mytool/ folder with mytool.bat inside
3. Commit & push
4. On other machines: git pull

Updating cmdx Commands

Commands in cmdx/ are generated by cmdx.

To update:

cd path/to/cmdx
python generate.py
copy out\*.bat C:\dev\winbat\cmdx\

Sync to Another Machine

git clone https://github.com/Jeffrey0117/winbat.git C:\dev\winbat
C:\dev\winbat\install.bat

---

License

MIT