Purrsona 🐾 🐾

A Chrome extension that helps developers stop overthinking their comments while keeping their Purrsonality.

"Stop overthinking. Start purrsonifying."

Demo

demo.mp4

🤖 AI Model

• Gemini 2.5 Flash - Fast, capable, and free tier eligible

Features

Core Features

• AI-Powered Comment Refinement - Transform your rough thoughts into polished comments using Gemini AI
• Optional Draft - Start from scratch or refine an existing draft
• Customizable Tone - Choose from Professional, Friendly, Curious, Technical, or Confident
• Length Options - Short, Balanced, or Detailed responses

Retro Pixel Theme

• Cute Cat UI - Delightful pixel art aesthetic with cat-themed elements
• Sound Effects - Satisfying click sounds, processing purr, and success meow
• Customizable - Toggle sounds on/off in settings

Platform Support

Platform	Status	Notes
dev.to	Active	Comment refinement on articles
LinkedIn	🔜 Planned	Future phase

Getting Started

Prerequisites

• Google Chrome browser
• Gemini API key (free tier works)

Installation

1. Clone the repository

   git clone https://github.com/carr-o-t/purrsona.git
   cd purrsona

2. Get a Gemini API Key

   • Visit Google AI Studio
   • Create a new API key
   • Copy the key

3. Load the Extension in Chrome

   • Open chrome://extensions/
   • Enable "Developer mode" (top right)
   • Click "Load unpacked"
   • Select the purrsona folder

4. Configure Settings

   • Click the Purrsona extension icon
   • Add your Gemini API key
   • Complete the Purrsona setup (2 writing samples)

Usage

First Time Setup

1. Click the 🐾 button on any comment textarea
2. If not configured, you'll be prompted to add your API key
3. Complete the Purrsona setup (2 short writing samples)
4. This helps maintain your authentic voice

Using Purrsona

1. Navigate to any dev.to article
2. Click into a comment textarea
3. Click the 🐾 button that appears
4. Optionally write a draft or leave empty for AI-generated comment
5. Select your preferred tone and length
6. Click "Purrsonify" and done

Settings

Access settings by:

• Clicking the ⚙️ button in the Purrsona modal
• Or visiting the extension options page

Configure:

• API Key - Your Gemini API key (stored locally)
• Your Purrsona - Writing samples that define your voice
• Sound - Toggle meow, purr, and click sounds

Development

Project Structure

purrsona/
├── content/
│   ├── platforms/     # Platform-specific code (dev.to, LinkedIn, etc.)
│   ├── services/     # Business logic (storage, Gemini, sound)
│   ├── ui/          # Reusable UI components
│   └── utils/       # Constants and utilities
├── settings/        # Extension options page
├── public/          # Static assets (images, sounds)
└── icons/           # Chrome store icons

Adding a New Platform

1. Create a new file in content/platforms/
2. Extend the PlatformBase class
3. Implement platform-specific methods:
   • isCommentTextarea() - Detect comment textareas
   • getArticleContext() - Extract article/context info
4. Register in content/content.js

Building

# No build step required - uses ES modules
# Just load the extension folder in Chrome

Screenshots

"Purrsona" in comment Textarea

Add Gemini Key

Main Modal

Settings Page

License

This project is licensed under the MIT License.

🐾 Built with ❤️ for developers