clipash 1.0.4

A clipboard-activated AI assistant powered by Gemini.

ClipAsh clipboard AI ⚡

Your secret AI assistant, just a hotkey away.

ClipAsh is a stealthy, clipboard-activated AI tool that lives in your background. Copy any text, press a hotkey, and get an answer from Google's Gemini directly back on your clipboard. It's designed for speed, efficiency, and to give you an unfair advantage in... well, anything.

🔥 Features

• Clipboard Activated: Just copy text (Ctrl+C) and press the hotkey. No need to open a new window or website.
• System-Wide Hotkey: Works anywhere on your system—browser, IDE, text editor, PDF, you name it.
• Conversation Memory: ClipAsh remembers your last 50 queries in a session, so you can ask follow-up questions and get context-aware answers.
• Stealth Mode:
  • Runs silently in the background with no visible window.
  • Chat history is encrypted and stored in a hidden system file.
  • Notifications are disguised as boring system messages (e.g., "Driver Update," "Files Synced").
• Kill Switch & Evidence Wipe: A special hotkey not only stops the script but also deletes all evidence, including the encrypted history, config file, and encryption key.
• Powered by Gemini: Uses Google's powerful Gemini models with a fallback system for reliability.

🚀 Installation

Getting ClipAsh is as simple as a pip command.

pip install clipash

🛠️ First-Time Setup

The first time you run ClipAsh, it will need a Gemini API key to work its magic.

1. Open your terminal (Command Prompt, PowerShell, etc.).
2. Run the command:

   clipash
   

3. A one-time setup prompt will appear, asking for your API key.
   • Option A (Recommended): Get a free Gemini API key and paste it in. This is the most reliable way.
   • Option B (Quick Test): Just press Enter to skip. ClipAsh will use a temporary, public key. Warning: This key might be slow, rate-limited, or could stop working at any time.

After this setup, ClipAsh will run silently in the background and will never ask you again.

💡 How to Use

The workflow is designed to be lightning fast:

1. Copy: Select any text on your screen and press Ctrl+C.
2. Call Aisha: Press the hotkey Ctrl+Shift+A.
3. Paste: Wait for the disguised system notification, then press Ctrl+V to paste the AI-generated answer.

⌨️ Hotkeys

• Activate ClipAsh: Ctrl + Shift + A
• Stop & Wipe All Data: Ctrl + Z (Use this "safe word" to instantly terminate the program and delete all config/history files).

📄 License

This project is licensed under the MIT License.

Coded with ❤️ by Aisha, based on the genius ideas of Heisenberg.