Suggest edit — cli-tools

Title

Name

Note

---
visibility: public
---

# CLI Tools

20 tools installable via Homebrew. All built by [Aayush Pokharel](https://aayush.art).

```bash
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 |