Skip to content

rosdyana/Potlot

Repository files navigation

Potlot

AI-powered writing assistant Chrome extension with multi-provider support.

Features

  • Multi-Provider Support: Use OpenAI, Anthropic (Claude), Google (Gemini), or Azure OpenAI
  • Quick Actions: One-click text improvements
    • Fix Grammar
    • Rewrite (improve clarity)
    • Summarize
    • Change Tone (Professional, Casual, Friendly)
    • Translate (configurable target language)
    • Explain (simplify complex text)
  • Custom Prompts: Create and use your own prompts from the Quick Actions panel
  • Chat Mode: Have a conversation with AI about your selected text
  • Voice Input: Speak your messages using the microphone button (Chrome only)
  • Works Everywhere: Select text on any webpage, including input fields and textareas
  • Keyboard Shortcut: Press Alt+W (or Ctrl+W on Mac) to open Potlot anytime
  • Prompt Library: Save and organize custom prompts for repeated use
  • History: View past AI interactions

Installation

From Source (Development)

  1. Clone the repository
  2. Install dependencies:
    pnpm install
  3. Build the extension:
    pnpm build
  4. Load in Chrome:
    • Go to chrome://extensions/
    • Enable "Developer mode" (top right)
    • Click "Load unpacked"
    • Select the .output/chrome-mv3/ folder

Development Mode

pnpm dev

This starts the extension in development mode with hot reload.

Setup

  1. Click the Potlot extension icon in your browser toolbar
  2. Click "Open Settings"
  3. Add your API key for at least one provider:
  4. Select your default model (optional)
  5. Configure your preferred translation language (optional, defaults to English)
  6. Save settings

Usage

Method 1: Text Selection

  1. Select any text on a webpage
  2. A small tooltip button appears near your selection
  3. Click the button to open Potlot
  4. Choose a Quick Action or switch to Chat mode

Method 2: Keyboard Shortcut

  1. Press Alt+W (Windows/Linux) or Ctrl+W (Mac)
  2. Potlot opens with any currently selected text
  3. If no text is selected, you can still use Chat mode

Quick Actions

Select text and click a Quick Action button:

Action Description
Fix Grammar Corrects spelling and grammar errors
Rewrite Improves clarity and readability
Summarize Creates a concise summary
Professional Rewrites in formal business tone
Casual Rewrites in relaxed, conversational tone
Friendly Rewrites in warm, approachable tone
Translate Translates to your configured target language
Explain Simplifies complex text for easier understanding

Custom Prompts

Your custom prompts appear below the built-in Quick Actions with a sparkle icon:

  1. Create prompts in Settings > Prompts tab
  2. Use {{text}} as a placeholder for selected text in your template
  3. Custom prompts appear automatically in the Quick Actions panel
  4. Click any custom prompt to apply it to your selected text

Chat Mode

For more complex tasks:

  1. Switch to the "Chat" tab
  2. Type your question or instruction
  3. The AI will respond with context from your selected text
  4. Continue the conversation as needed

Voice Input

  1. Click the microphone button in Chat mode
  2. Speak your message
  3. Click again to stop recording
  4. Your speech is converted to text automatically

Prompt Library

Save frequently used prompts:

  1. Go to Settings > Prompts tab
  2. Click "Add Prompt"
  3. Enter a title and template
  4. Organize prompts into folders
  5. Use {{text}} as placeholder for selected text

Translation Settings

Configure your preferred translation language:

  1. Go to Settings
  2. Find "Translate Target Language" dropdown
  3. Select from 20 supported languages:
    • English, Spanish, French, German, Italian, Portuguese, Dutch, Russian
    • Chinese (Simplified), Chinese (Traditional), Japanese, Korean
    • Arabic, Hindi, Indonesian, Thai, Vietnamese, Turkish, Polish, Swedish
  4. Save settings
  5. The "Translate" quick action will now translate to your chosen language

History

View past interactions:

  1. Go to Settings > History tab
  2. Click any entry to expand and see full output
  3. Delete individual entries or clear all history

Keyboard Shortcuts

Shortcut Action
Alt+W / Ctrl+W (Mac) Open/close Potlot
Enter Send message (in Chat)
Shift+Enter New line (in Chat)
Escape Close Potlot modal

Supported Models

OpenAI

  • GPT-4.1 (default)
  • GPT-4.1 Mini
  • GPT-4.1 Nano
  • GPT-4o
  • GPT-4o Mini
  • o3, o3 Mini
  • o1, o1 Mini

Anthropic

  • Claude Sonnet 4 (default)
  • Claude 3.5 Sonnet
  • Claude 3.5 Haiku
  • Claude 3 Opus

Google

  • Gemini 2.5 Flash (default)
  • Gemini 2.5 Pro
  • Gemini 2.0 Flash
  • Gemini 2.0 Flash Lite

Azure OpenAI

  • Custom deployment (configure in settings)

You can also specify a custom model ID for any provider.

Privacy

  • API keys are stored locally on your device only (never synced)
  • Settings sync across your Chrome browsers (if signed in)
  • History is stored locally and never sent anywhere except to your chosen AI provider
  • No analytics or tracking - the extension only communicates with AI provider APIs

Tech Stack

Development

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Type check
pnpm compile

# Build for production
pnpm build

# Build for Firefox
pnpm build:firefox

# Create distributable zip
pnpm zip

License

MIT

About

AI-powered writing assistant Chrome extension with multi-provider support.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages