Skip to content

sunkencity999/typemagic

BranchesTags

Repository files navigation

TypeMagic

AI-Powered Writing Assistant — Web Editor, Mac App & Chrome Extension

TypeMagic is an AI-powered writing assistant that polishes your text while preserving your unique voice. Available as a full-featured web editor, a native Mac app, and a Chrome extension.

  • Web Editor — typemagic.pro/app — Full writing environment with AI polish, inline suggestions, voice profiles, translation, templates, voice dictation, analytics, and more.
  • Mac App — System-wide shortcut: select text anywhere, press Cmd+Option+T, and get polished text instantly.
  • Chrome Extension — Bring TypeMagic polish to any text field on the web.

Web Editor Features

The web editor at typemagic.pro is a premium writing environment ($12/month) with:

  • AI Actions — Polish, Summarize, Bullets, Markdown, Custom prompt
  • Inline Suggestions (Check) — Grammarly-style colored underlines with accept/dismiss per issue
  • Sentence Rephrase — Select text, get 3 alternative phrasings, click to replace
  • Real-Time Translation — 13 languages with polished, natural-sounding output
  • AI Document Templates — 8 pre-built templates (Cover Letter, Cold Email, Meeting Summary, Project Proposal, Blog Post, Complaint Letter, Thank You Note, Executive Summary)
  • AI Voice Profiles — Create writing personas with traits and sample text; AI emulates your style
  • Voice Dictation — Built-in microphone input via Web Speech API (Chrome/Edge/Safari)
  • Writing Goals — Audience, Formality, Domain, and Intent selectors injected into every prompt
  • Personal Dictionary — Add words the Check engine should never flag
  • Writing Analytics Dashboard — Track words written, sessions, readability trends, streaks, and 12 gamified milestones
  • Document Storage — Firestore-backed save/open/new with auto-save
  • Multi-Format Export — Download as .txt, .docx, or .pdf
  • Diff View — See exactly what the AI changed with red/green highlighting
  • Readability Score — Real-time Flesch-Kincaid score (0–100) with animated ring
  • Tone Selector — Keep, Professional, Casual, Friendly, Concise
  • Dark Mode — Full dark theme

For web editor setup, see typemagic_website/SETUP.md.

Chrome Extension

Core Features

  • Keyboard Shortcut: Press Cmd+Option+T (Mac) or Ctrl+Alt+T (Windows/Linux) for instant corrections
  • Tone Adjustment: Choose between "Keep My Voice", "More Professional", or "More Casual"
  • Quick Actions: Convert to bullet points or create concise summaries with one click
  • Universal Compatibility: Works on any webpage with text inputs (email, docs, social media, etc.)
  • Multiple AI Providers: Support for OpenAI, Google Gemini, Anthropic Claude, Ollama, and custom FastAPI endpoints
  • Smart Formatting: Optionally use Markdown to format your text with headers, lists, bold, italic, etc.
  • One-Click Correction: Click the extension icon and press "Correct Text" to apply corrections
  • Google Docs Support: Manual copy/paste workflow for Google Docs compatibility
  • Privacy-Focused: Your API keys are stored locally; text is only sent to your chosen AI provider
  • Clean UI: Beautiful popup interface with gradient design

New in v1.5.0

  • Undo Functionality: Revert corrections with Cmd+Option+Z (Mac) or Ctrl+Alt+Z (Windows/Linux), or use the Undo button
  • Quick Provider Switching: Change AI providers directly from the popup without opening settings
  • Side-by-Side Diff View: See exactly what changed with color-coded additions and deletions
  • Custom Dictionary: Add terms to preserve (brand names, technical terms) or auto-replace in Settings
  • Correction Statistics: Track your daily, weekly, and total corrections with a badge on the extension icon
  • Keyboard Navigation: Full keyboard control in popup (⌘↵ correct, ⌘B bullets, ⌘⇧S summarize, 1/2/3 tone)
  • Onboarding Wizard: First-time setup guide helps new users configure their AI provider
  • Better Error Handling: Automatic retry with exponential backoff for transient API errors
  • Improved Ollama Installers: One-click installers for macOS, Linux, and Windows with automatic CORS configuration

Installation

From Source (Development)

  1. Clone or download this repository

    git clone https://github.com/sunkencity999/typemagic.git
cd typemagic

  2. Load the extension in Chrome

    • Open Chrome and navigate to chrome://extensions/
    • Enable "Developer mode" (toggle in top-right corner)
    • Click "Load unpacked"
    • Select the typemagic folder
    • The extension should now appear in your extensions list!

Setup & Configuration

1. Choose Your AI Provider

Click the TypeMagic icon in your Chrome toolbar, then click "Open Settings". Choose from:

OpenAI (Recommended for best quality)

  • Get API key: platform.openai.com/api-keys
  • Recommended model: gpt-4o-mini (fast and cost-effective)
  • Cost: ~$0.150 per 1M input tokens, $0.600 per 1M output tokens

Google Gemini (Great free tier)

Anthropic Claude (Excellent for nuanced corrections)

Ollama (100% Local & Free)

  • Install Ollama: ollama.ai
  • Run: ollama run llama3.2 (or any model of your choice)
  • Default endpoint: http://localhost:11434
  • Cost: Free! (runs on your machine)

FastAPI (Custom Endpoint)

  • For self-hosted AI services
  • By default the extension needs only the URL of your endpoint. It does not pass model name or a password.
  • Your endpoint should accept POST requests with: 
    {
  "system": "System prompt string",
  "text": "Text to correct"
}
  • And return: 
    {
  "corrected_text": "Corrected text here"
}

2. Enable Markdown Formatting (Optional)

Toggle "Use Markdown Formatting" in settings to have the AI format your text with:

  • Headers (# H1, ## H2, etc.)
  • Bold and italic text
  • Lists (bullet points and numbered)
  • And more Markdown features

3. Customize System Prompt (Advanced)

Create your own instructions for the AI by editing the "Custom System Prompt" field. This allows you to:

  • Specify a particular writing style
  • Add domain-specific vocabulary
  • Control formatting preferences
  • Adjust the level of corrections (e.g., "only fix spelling, keep grammar as-is")

Usage

Quick Keyboard Shortcut (Recommended)

  1. Click inside any text field in your browser.
  2. Press Cmd+Option+T (Mac) or Ctrl+Alt+T (Windows/Linux)
  3. Your text is instantly corrected in place!

This works anywhere you can type online—just place your cursor, use the shortcut, and TypeMagic handles the rest.

Using the Popup

For Google Docs

  1. Select and copy the text you want to correct in Google Docs (Cmd/Ctrl+C)
  2. Click the TypeMagic extension icon in your Chrome toolbar
  3. Paste the text into the textarea at the top of the popup
  4. Select your desired tone (Keep My Voice, More Professional, or More Casual)
  5. Click "Correct Text", "Convert to Bullets", or "Summarize"
  6. The corrected text is automatically copied to your clipboard
  7. Paste back into Google Docs (Cmd/Ctrl+V)

For Other Sites (Text Fields, Email, Social Media)

  1. Click in any text field (textarea, input, contentEditable element)
  2. Click the TypeMagic extension icon in your toolbar
  3. Select your desired tone
  4. Click "Correct Text"
  5. Your text is automatically corrected in place!

Tips for Best Results

  • Works best with at least a few sentences of text
  • Great for quickly drafting emails, posts, and messages
  • For partial corrections: Select only the text you want to fix before using the keyboard shortcut
  • Review AI suggestions—they're usually excellent but not always perfect
  • Google Docs requires the manual copy/paste workflow due to browser security restrictions
  • Use the keyboard shortcut (Cmd+Option+T / Ctrl+Alt+T) for the fastest workflow

Supported Websites

TypeMagic works on virtually any site with text inputs (email, docs, chat, note-taking, developer tools, etc.). Anywhere you can type, you can copy text, press the shortcut, and paste polished writing back in.

Privacy & Security

  • API keys stored locally: Your credentials never leave your machine except to call the AI provider
  • No tracking: TypeMagic doesn't collect any analytics or usage data
  • Minimal permissions: Only requests necessary permissions for functionality
  • Your choice of provider: Use local AI (Ollama) for complete privacy

Troubleshooting

Extension Not Working

  • Ensure you're clicking in a text field before opening the popup
  • For Google Docs: Use the textarea in the popup (copy/paste workflow)
  • Refresh the page after installing or updating the extension

API Errors

  • Verify your API key is correct in settings
  • Check your API provider's dashboard for rate limits or billing issues
  • For Ollama: Ensure Ollama is running (ollama serve)
  • Test connection using the "Test Connection" button in the popup

Text Not Replacing

  • Some rich text editors may not be fully supported
  • Try selecting all text and pasting manually if auto-replacement fails
  • Check browser console (F12) for error messages

Performance Issues

  • Use faster models like gpt-4o-mini or llama3.2 for quicker responses
  • Consider Ollama for completely local processing
  • Large text blocks may take longer to process

Development

Project Structure

typemagic/
├── manifest.json          # Extension configuration
├── content.js            # Injects icons and handles UI
├── background.js         # API calls and text processing
├── popup.html/js         # Extension popup interface
├── options.html/js       # Settings page
├── styles.css            # Styling for injected elements
├── icons/                # Extension icons
│   ├── icon16.png
│   ├── icon48.png
│   ├── icon128.png
│   └── generate-icons.html
└── README.md             # This file

Key Technologies

  • Chrome Extensions Manifest V3: Modern extension architecture
  • Content Scripts: DOM manipulation and UI injection
  • Service Workers: Background processing and API calls
  • Chrome Storage API: Persistent settings storage

Adding New AI Providers

To add support for a new AI provider:

  1. Add provider option in options.html:

    <label class="provider-option" data-provider="newprovider">
  <input type="radio" name="provider" value="newprovider">
  <div>New Provider</div>
</label>

  2. Add configuration section in options.html:

    <div class="provider-config" data-provider="newprovider">
  <!-- Add API key, model selection, etc. -->
</div>

  3. Implement API call in background.js:

    async function callNewProvider(prompt, apiKey, model) {
  // Implement API call logic
  // Return corrected text string
}

  4. Add to switch statement in handleTextCorrection():

    case 'newprovider':
  return await callNewProvider(prompt, settings.newproviderKey, settings.newproviderModel);

Future Enhancements

Potential features for future versions:

  • Undo/redo functionality ✅ Added in v1.5.0
  • Side-by-side comparison view ✅ Added in v1.5.0
  • Custom correction rules/dictionary ✅ Added in v1.5.0
  • Browser action badge showing correction count ✅ Added in v1.5.0
  • Streaming responses for real-time feedback
  • Language detection and translation ✅ Added in Web Editor (13 languages)
  • Firefox and Safari support
  • Shared prompt templates library ✅ Added in Web Editor (8 AI Document Templates)

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

License

MIT License - feel free to use and modify as needed.

Support

For issues, questions, or suggestions:

  • Open an issue on GitHub
  • Check existing issues for solutions
  • Review the troubleshooting section above

Developer

Christopher Bradford
Email: admin@robotbirdservices.com
Version: 1.5.0

Type fast, correct faster with TypeMagic.

About

A Chrome extension that allows for immediate refactoring and spell-checking of text, allowing the user to type freely as fast as they can move their fingers.

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 1

TypeMagic Ollama Installers v1.0.0 Latest
Nov 28, 2025

Packages

 
 
 

Contributors

Languages