CLI Tools
20 tools installable via Homebrew. All built by Aayush Pokharel.
brew tap aayush9029/tap
brew install <tool>
Developer Tools
doq
Query Apple developer documentation from your terminal. Search symbols, view declarations, docs, availability, and relationships.
- Language: Go
- Install:
brew install aayush9029/tap/doq
bump
Bump Xcode project marketing version from the command line. Supports patch, minor, major, or interactive mode.
- Language: Shell
- Install:
brew install aayush9029/tap/bump
spu
Check and update Swift package dependencies from the command line.
- Language: Shell
- Install:
brew install aayush9029/tap/spu
icn
Generate .icon and .png files from SF Symbols.
- Language: Swift
- Install:
brew install aayush9029/tap/icn
findertags
Read and modify Finder tags from the command line.
- Language: Swift
- Install:
brew install aayush9029/tap/findertags
AI & LLM Tools
peek
Describe images and videos from the terminal using vision LLMs. Requires OPENROUTER_API_KEY.
- Language: Shell
- Install:
brew install aayush9029/tap/peek
sip
Summarize stdin using LLMs. Pipe anything into it for an instant summary. Requires OPENROUTER_API_KEY.
- Language: Shell
- Install:
brew install aayush9029/tap/sip
play-happy
Celebrate wins with random meme videos and text overlays. Built for AI agents (and humans) who ship.
- Language: Shell
- Install:
brew install aayush9029/tap/play-happy
Communication
imsg
Human-first macOS CLI for Messages.app. Read chats/history, send messages, resolve phone/email handles to Contacts names.
- Language: Swift
- Install:
brew install aayush9029/tap/imsg
tmail
Disposable email in your terminal. Generate temp inboxes, list messages, read verification codes.
- Language: Go
- Install:
brew install aayush9029/tap/tmail
apple-mail-exporter
Search and export emails from Apple Mail's local database. Requires Full Disk Access.
- Language: Swift
- Install:
brew install aayush9029/tap/apple-mail-exporter
File & Media
meow
Upload files to catbox.moe & litterbox from the terminal. Supports multi-file, URL re-hosting, and temporary uploads.
- Language: Go
- Install:
brew install aayush9029/tap/meow
haze
Progressive blur, grain, and gradient color overlay for video. Requires ffmpeg.
- Language: Shell
- Install:
brew install aayush9029/tap/haze
System & Network
watts
Figure out what is actually draining your MacBook battery. Installs a boot daemon to track power usage.
- Language: Go
- Install:
brew install aayush9029/tap/watts
noz
Prevent your Mac from sleeping when the lid is closed. Default 45 minutes, configurable.
- Language: Shell
- Install:
brew install aayush9029/tap/noz
goping
Ping with live stats — like ping but with a persistent stats bar.
- Language: Go
- Install:
brew install aayush9029/tap/goping
loca
Get your Mac's current location from the terminal.
- Language: Swift
- Install:
brew install aayush9029/tap/loca
Internet & Browsing
wiki
Search and read Wikipedia from your terminal.
- Language: Go
- Install:
brew install aayush9029/tap/wiki
nit
Personal Twitter feed reader for the terminal. Requires TWITTER_BEARER_TOKEN.
- Language: Go
- Install:
brew install aayush9029/tap/nit
Quick Reference
| Tool | What it does | Language |
|---|---|---|
| doq | Apple dev docs in terminal | Go |
| bump | Bump Xcode version | Shell |
| spu | Update Swift packages | Shell |
| icn | SF Symbol → .icon/.png | Swift |
| findertags | Finder tags CLI | Swift |
| peek | Describe images/video via LLM | Shell |
| sip | Summarize stdin via LLM | Shell |
| play-happy | Celebration meme videos | Shell |
| imsg | Messages.app CLI | Swift |
| tmail | Disposable email | Go |
| apple-mail-exporter | Export Apple Mail | Swift |
| meow | Upload to catbox.moe | Go |
| haze | Video blur/grain overlay | Shell |
| watts | Battery drain analysis | Go |
| noz | Prevent lid-close sleep | Shell |
| goping | Ping with live stats | Go |
| loca | Current location | Swift |
| wiki | Wikipedia reader | Go |
| nit | Twitter feed reader | Go |