kayko

Kayko - Never Lose Your Prompts Again 🛡️

**Auto-save your LLM prompts locally. Complete privacy. Zero configuration.** [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Chrome](https://img.shields.io/badge/Chrome-Compatible-green.svg)](https://www.google.com/chrome/) [![Edge](https://img.shields.io/badge/Edge-Compatible-blue.svg)](https://www.microsoft.com/edge)

🎯 Overview

Kayko solves the frustrating problem of losing carefully crafted prompts when browser tabs crash, pages refresh unexpectedly, or sessions timeout. This extension runs entirely on your local computer, ensuring complete privacy while providing seamless auto-save functionality across all major LLM platforms.

✨ Key Features

🔄 Auto-Save Functionality

Automatically detects and saves all text written in LLM chat textareas
Saves prompts every 3 seconds while you type (debounced for performance)
Works on ChatGPT, Claude, Gemini, Grok, Perplexity, and any text-based LLM interface
Zero configuration required - install and forget

🎨 Smart UI Design

Small, unobtrusive icon appears on the right side of every textarea
Icon shows save status:
- Gray: Idle/ready
- Blue spinning: Saving in progress
- Green checkmark: Successfully saved
Single click on icon opens history panel
Clean, minimal interface that doesn’t interfere with your workflow

📜 History Panel

Right-side panel displays chronological list of saved prompts
Search and filter prompts by keywords, date, or LLM website
One-click to copy any previous prompt
Preview first 200 characters of each prompt for quick identification
Star/favorite important prompts for quick access
Expandable view to see full prompt text

🔒 Privacy & Performance

All processing happens locally - no server uploads
Prompts stored in browser’s local storage - never leave your computer
Minimal CPU usage (< 1% overhead)
Works offline - no internet connection required
Option to exclude sensitive websites from auto-save

💾 Storage Management

Keeps last 100 prompts by default (configurable up to 1000)
Export prompts as JSON for backup
Import previously exported prompts
Clear history option with confirmation

🚀 Installation

Method 1: Load Unpacked (Development)

Clone or download this repository

git clone https://github.com/yourusername/kayko.git
cd kayko

Build the icon files (optional but recommended)
```
npm install
npm run build-icons
```
If you skip this step, you’ll need to manually create PNG icons from icons/icon.svg at sizes: 16x16, 32x32, 48x48, and 128x128.
Load the extension in Chrome/Edge
- Open Chrome/Edge and navigate to chrome://extensions/
- Enable “Developer mode” (toggle in top-right corner)
- Click “Load unpacked”
- Select the kayko directory
- The extension is now installed! 🎉

Method 2: Install from Chrome Web Store

Coming soon - awaiting approval

📖 How to Use

Automatic Saving

Visit any LLM website (ChatGPT, Claude, Gemini, etc.)
Start typing in the chat textarea
Notice the small Kayko icon appears on the right side
Your prompt is automatically saved every 3 seconds
The icon shows:
- 🔵 Blue spinning animation while saving
- ✅ Green checkmark when saved successfully

Viewing Saved Prompts

Method 1: Click the Kayko icon next to any textarea Method 2: Click the Kayko extension icon in your browser toolbar Method 3: Right-click the extension icon → “View saved prompts”

Using the History Panel

Search: Type keywords in the search bar to filter prompts
Filter by Platform: Select specific LLM (ChatGPT, Claude, etc.)
Filter by Date: Show prompts from today, this week, or this month
Favorites: Click the star icon to mark favorites, then filter by favorites
Copy: Click “Copy” button to copy prompt to clipboard
View Full: Click “View Full” to expand and see complete prompt
Delete: Click “Delete” to remove individual prompts

Managing Settings

Click the settings icon (⚙️) in the history panel to configure:

Maximum prompts to keep: Set between 10-1000 (default: 100)
Excluded sites: Add domains where auto-save should be disabled
Enable/disable auto-save: Toggle the entire auto-save feature

Export & Import

Export Prompts:

Open the history panel
Click “Export” at the bottom
Prompts are saved as kayko-prompts-YYYY-MM-DD.json

Import Prompts:

Open the history panel
Click “Import” at the bottom
Select a previously exported JSON file
Prompts are merged with existing ones (no duplicates)

🌐 Supported Platforms

Kayko works on all major LLM platforms:

✅ ChatGPT (chat.openai.com)
✅ Claude (claude.ai)
✅ Gemini (gemini.google.com)
✅ Grok (x.ai)
✅ Perplexity (perplexity.ai)
✅ Any website with text inputs

🔧 Technical Details

Architecture

kayko/
├── manifest.json           # Extension configuration (Manifest V3)
├── content.js             # Content script (textarea detection & auto-save)
├── content.css            # Icon styles
├── background.js          # Service worker (storage management)
├── sidepanel.html/css/js  # History panel UI
├── popup.html/css/js      # Extension popup UI
└── icons/                 # Extension icons (16, 32, 48, 128px)

Permissions

storage: Save prompts to local browser storage
activeTab: Detect textareas on current page
sidePanel: Display history panel

Storage

Uses Chrome’s chrome.storage.local API
Each prompt stores:
- id: Unique identifier
- text: Prompt content
- platform: LLM platform name
- url: Page URL
- timestamp: When saved
- favorite: Boolean flag

Performance

Memory: ~20-30MB when panel is open
CPU: <1% during active typing
Storage: ~5-10MB for 100 prompts
Network: None (completely offline)

🛠️ Development

Project Structure

// content.js - Main auto-save logic
- Detects textareas on page
- Injects save icon
- Handles debounced saving
- Communicates with background script

// sidepanel.js - History management
- Displays saved prompts
- Search and filter functionality
- Export/import features
- Settings management

// background.js - Service worker
- Manages storage
- Updates badge count
- Handles side panel opening

Building for Production

# Install dependencies
npm install

# Build icons
npm run build-icons

# Package extension
npm run package

This creates dist/kayko-extension.zip ready for Chrome Web Store submission.

Customization

Change auto-save delay: Edit DEBOUNCE_DELAY in content.js (default: 3000ms)

Change max prompts: Edit default in background.js or use Settings UI (default: 100)

Add new LLM platform: Add domain to host_permissions in manifest.json

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Bug Reports & Feature Requests

Found a bug or have a feature idea? Please open an issue on GitHub.

⚠️ Known Limitations

Some websites with heavy JavaScript frameworks may require a page refresh for icon to appear
Dynamically loaded textareas are detected within 2 seconds
Browser’s local storage has a size limit (~10MB total) shared with other extensions

📊 Privacy Policy

Kayko collects ZERO data. Everything stays on your computer:

✅ No server communication
✅ No analytics or tracking
✅ No third-party services
✅ No user accounts or logins
✅ All data stored locally in browser

🙏 Acknowledgments

Inspired by the need for reliable prompt recovery across LLM platforms
UI design inspired by Grammarly’s unobtrusive approach
Built with modern Web Extensions APIs (Manifest V3)

📞 Support

Need help?

📖 Read the Documentation
💬 Join our Discussions
🐛 Report bugs via Issues
⭐ Star the repo if you find it useful!

**Made with ❤️ for the AI community** [GitHub](https://github.com/yourusername/kayko) • [Report Bug](https://github.com/yourusername/kayko/issues) • [Request Feature](https://github.com/yourusername/kayko/issues)

This site is open source. Improve this page.