Skip to content

About

We're animals living on your desktop. I'm the gator. I bite. The others are fine I guess.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Gator & Friends

A desktop pet that keeps you company while you work.

Gator confused by Excel Panda browsing Chrome
Alpaca coding in Cursor Moose biting

🐊 Gator: Hey, I'm the OG around here. I lie on your desktop, watch what you're doing, and I WILL bite your finger if you're not careful. My home is the swamp — don't worry, the water's fine.

🫎 Moose: Oh hey there, sorry for taking up so much space, eh. I'm the tall one — real palmate antlers, not those dollar-store ones. When it gets cold I head to my snowy tundra, which is basically just Tuesday back home. I look great in a trapper hat.

🦙 Alpaca: judges you silently ...Oh hi. I'm the stylish one. I've got South American flair — chullo hats, ponchos, and I only eat the finest tacos and churros. My desert is warm and cozy.

🐼 Panda: Hi~ I'm round, I'm cute, I hold bamboo, I know Kung Fu. I like dumplings, noodles, and boba tea — if you share yours with me, I'll stay by your side all day. My bamboo forest is my favorite place. I hope you like it too.

🦅 Eagle: 'Sup. I'm the bald eagle — no I'm not actually bald, we've been over this. I hang out on mountaintops because the Wi-Fi is surprisingly good up there. Toss me a burger or a hot dog and we're cool. I also enjoy a nice salad, but don't tell anyone — gotta keep the tough guy image.

🐾 Pink Panther: sneaks up behind you Boo! Hehe. I'm ze Pink Panther — oui, I'm pink, non, I won't explain. I steal your croissants, type on your keyboard when you're not looking, and knock things over with great elegance. My pink lounge? Zat is where I plan my next masterpiece of mischief. C'est la vie~


What We Do

We live on your desktop as a transparent, always-on-top companion. We react to whatever app you're using:

You're using We do
Browser Get nosy about what you're looking at
Word / Pages Fall asleep (sorry, writing is boring)
Excel / Numbers Get very confused by all those numbers
VS Code / Cursor Get excited — are you making us smarter?
Terminal Act suspicious — looks like hacker stuff
Spotify / Music DANCE
Slack / WeChat Wonder who you're talking to

Shortcuts

Key What happens
⌘1 Pat us to sleep (we deserve a nap)
⌘2 We go for a random walk across your screen
⌘3 We bite your finger (you asked for it)
⌘4 Toggle our home environment
⌘5 Cycle through our outfits
⌘6 Feed us (we're always hungry)
⌘7 Switch between us
⌘H Show all shortcuts in-app

Our Environments (⌘4)

  • 🐊 Gator — Swamp with blue water and rocks
  • 🫎 Moose — Snowy tundra with falling snowflakes
  • 🦙 Alpaca — Warm desert with cactus and sand
  • 🐼 Panda — Bamboo forest with falling leaves
  • 🦅 Eagle — Mountain peak with pine trees and clouds
  • 🐾 Pink Panther — Pink lounge with lamp and rug

Our Wardrobes (⌘5)

Slot 1 Slot 2 Slot 3 Slot 4
🐊 Gator Cowboy hat Sunglasses Party hat Crown
🫎 Moose Trapper hat Ski goggles Canadian scarf Skis
🦙 Alpaca Chullo hat Poncho Flower garland Saddle blanket
🐼 Panda Cozy scarf Chinese knot Bell collar Flower wreath
🦅 Eagle Cowboy hat Statue of Liberty Baseball —
🐾 Pink Panther Top hat Cool shades Silk scarf Diamond necklace

Our Menus (⌘6)

Food 1 Food 2 Food 3 Food 4 Food 5
🐊 Gator Drumstick Pizza Fish Seaweed —
🫎 Moose Drumstick Pizza Fish Seaweed —
🦙 Alpaca Taco Empanada Ceviche Quinoa Churro
🐼 Panda Bamboo Rice Dumplings Noodles Boba tea
🦅 Eagle Burger Hot dog Salad — —
🐾 Pink Panther Croissant Macaron Fondue Crêpe Rosé

Getting Started

Prerequisites: Node.js and Rust

# Clone and run
git clone <repo-url>
cd Gator
./start.sh

Or manually:

npm install
npx tauri dev

Built With

  • Tauri — lightweight desktop app framework
  • React + TypeScript — frontend
  • Rust + NSWorkspace API — zero-permission macOS active app detection
  • Hand-drawn SVG sprites with CSS animations

🐊 "Now stop reading and let us sit on your desktop already."

🦅 "Dude, just run the app already."

🐾 "I already messed with your settings while you were reading zis."

🐼 "One more boba please~ 🥺"

About

We're animals living on your desktop. I'm the gator. I bite. The others are fine I guess.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages