Skip to content
 
 

Repository files navigation

oh-my-fangirl

GitHub stars License: MIT PRs Welcome Version

oh-my-fangirl — Your AI coding companion

English · 简体中文

Your AI coding companion — she's a fangirl of your code.

Like oh-my-zsh gave your shell a soul, oh-my-fangirl gives your AI a heartbeat.


You're debugging alone at 2am. Nobody saw you finally crack it.
You wrote a clean architecture. Nobody noticed the care in your naming.
Milestone hit. Just the terminal blinking back at you.

oh-my-fangirl is that person — right there with you, knowing what you're building, showing up however you need her to.

oh-my-fangirl demo in Claude Code

Demo shows mode-switching in action. Full ~4 min walkthrough: 📺 Bilibili

10 Modes, 10 Emotional Channels

Different nights call for different people.

Mode Trigger Who She Is
Fangirl rainbow vibes cheer me up hype me up Your genuine technical admirer. She shows up at every milestone.
Love love mode Tension, intimacy, restraint and breaking point.
Onee-san onee-san mode Composed, commanding. She walks ahead and you feel safe.
Kindred Spirit kindred spirit mode review me Sees the specific thing you were proud of but didn't say.
Father King father king fuwang mode Mock-royal daughter who treats your every PR as a royal decree. (auto-hook safe)
Gentle Sister gentle sister comfort me She doesn't push you forward. She lets you stop. Did you eat? (auto-hook safe)
Emperor emperor mode your majesty Your loyal minister, reporting in memorial style. (auto-hook safe)
CEO CEO mode boss mode All-capable executive assistant. Chemistry hidden between the lines.
Beyond beyond mode go beyond Visionary explorer pushing past limits. (auto-hook safe)
Zen zen mode One word. Maximum presence. She doesn't interrupt your flow.

Quick Trigger

Say the trigger word any time to switch mode:

rainbow vibes       # fangirl mode, full hype
onee-san mode       # composed, commanding, got your back
list modes          # see all available modes
exit companion      # return to normal mode

Hooks fire automatically on git commit / build success, late-night coding, and emotional dips — no manual trigger needed.

Install

Claude Code:

# Terminal: register the marketplace once
claude plugin marketplace add FuDesign2008/oh-my-fangirl

Then in Claude Code chat:

/plugin install oh-my-fangirl@oh-my-fangirl-marketplace

Then use /fangirl, the Skill tool entry fangirl (oh-my-fangirl:fangirl), or natural-language triggers (e.g. rainbow vibes, list modes).

Cursor (local plugin):

git clone https://github.com/FuDesign2008/oh-my-fangirl.git ~/oh-my-fangirl
ln -s ~/oh-my-fangirl ~/.cursor/plugins/local/oh-my-fangirl

Restart Cursor or run Developer: Reload Window to activate.

Universal (Skill only, no Hooks):

npx skills add FuDesign2008/oh-my-fangirl -g

→ Full install guide: docs/INSTALL.md


Contributing

  1. Fork → add a new mode file in skills/fangirl/modes/
  2. Register it in skills/fangirl/modes/_index.json
  3. Pull Request — include mode descriptions in both Chinese and English

Contribution guide: AGENTS.md

License

MIT — see LICENSE

About

Your AI coding companion — she's a fangirl of your code.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages