index 7166e36..a15f27e 100644
@@ -4,32 +4,154 @@ visibility: public
# CLI Tools
-Command-line tools built in Go, Shell, and Swift. Install via:
+20 tools installable via Homebrew. All built by [Aayush Pokharel](https://aayush.art).
```bash
brew tap aayush9029/tap
+brew install <tool>
```
-## Go
+---
+
+## 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`
+
+---
-- **[doq](https://github.com/Aayush9029/doq)** (10 stars) — Query Apple developer documentation from your terminal
-- **[watts](https://github.com/Aayush9029/watts)** (1 star) — See why your Mac's battery sucks
-- **[tmail](https://github.com/Aayush9029/tmail)** (1 star) — Disposable email in your terminal
-- **[wiki](https://github.com/Aayush9029/wiki)** — Search and read Wikipedia from your terminal
-- **[nit](https://github.com/Aayush9029/nit)** — Browse tweets from the terminal via Nitter instances
-- **[meow](https://github.com/Aayush9029/meow)** — Upload files to catbox.moe & litterbox from the terminal
-- **[goping](https://github.com/Aayush9029/goping)** — Network ping utility
+## AI & LLM Tools
-## Shell
+### peek
+Describe images and videos from the terminal using vision LLMs. Requires `OPENROUTER_API_KEY`.
+- **Language:** Shell
+- **Install:** `brew install aayush9029/tap/peek`
-- **[peek](https://github.com/Aayush9029/peek)** (11 stars) — Describe and rename images using vision LLMs
-- **[haze](https://github.com/Aayush9029/haze)** — Progressive blur, grain, and gradient color overlay for video
-- **[sip](https://github.com/Aayush9029/sip)** — Summarize stdin using LLMs
-- **[noz](https://github.com/Aayush9029/noz)** — Prevent Mac from sleeping with the lid closed
-- **[spu](https://github.com/Aayush9029/spu)** — Shell utility
-- **[bump](https://github.com/Aayush9029/bump)** — Version bumping utility
+### 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`
+
+---
-## Swift
+## Quick Reference
-- **[apple-mail-exporter](https://github.com/Aayush9029/apple-mail-exporter)** — Search and export emails from Apple Mail's local database
-- **[loca](https://github.com/Aayush9029/loca)** — Location utility
\ No newline at end of file
+| 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 |
\ No newline at end of file