[GH-ISSUE #243] ALwrity Assistive writing powered by Exa AI #164

Closed
opened 2026-03-02 23:34:06 +03:00 by kerem · 3 comments
Owner

Originally created by @AJaySi on GitHub (Sep 7, 2025).
Original GitHub issue: https://github.com/AJaySi/ALwrity/issues/243

Originally assigned to: @AJaySi on GitHub.

Feature Concept: "Smart Writing Assistant"
�� Core Functionality
Real-time writing assistance as users type
Contextual suggestions based on current content
Automatic citations with relevant sources
Seamless integration with existing LinkedIn editor
🔧 Implementation Approach

  1. Toggle Switch in Header
  2. Trigger Conditions
    Word count trigger: After 5-6 words typed
    Sentence completion: After first sentence
    Time-based: After 3-5 seconds of inactivity

Time-based: After 3-5 seconds of inactivity
Manual trigger: User presses Ctrl+Space or clicks suggestion button
3. Suggestion Display
Inline suggestions appear below current text
Citation previews with source titles and URLs
Accept/Reject buttons for each suggestion
"Continue writing..." prompts with relevant context

Smart Triggers
Contextual: "The AI market is growing..." → Suggests statistics
Question-based: "What are the benefits of..." → Suggests answers
Opinion-based: "I believe that..." → Suggests supporting evidence

Implementation Phases
Phase 1: Basic Assistant
Toggle switch in header
Basic text continuation suggestions
Simple accept/reject interface
Exa integration for source finding
Phase 2: Enhanced Features
Contextual suggestions based on draft content
Citation integration with fact-check system
Multiple suggestion types (continuation, enhancement, citation)
Smart triggering based on content analysis

Phase 3: Advanced Intelligence
Learning from user behavior
Industry-specific suggestions
Tone and style matching
Integration with LinkedIn analytics
�� Key Benefits
For Users
Faster writing with intelligent suggestions
Better content quality with verified sources
Reduced writer's block with contextual prompts
Professional credibility with automatic citations

Originally created by @AJaySi on GitHub (Sep 7, 2025). Original GitHub issue: https://github.com/AJaySi/ALwrity/issues/243 Originally assigned to: @AJaySi on GitHub. Feature Concept: "Smart Writing Assistant" �� Core Functionality Real-time writing assistance as users type Contextual suggestions based on current content Automatic citations with relevant sources Seamless integration with existing LinkedIn editor 🔧 Implementation Approach 1. Toggle Switch in Header 2. Trigger Conditions Word count trigger: After 5-6 words typed Sentence completion: After first sentence Time-based: After 3-5 seconds of inactivity Time-based: After 3-5 seconds of inactivity Manual trigger: User presses Ctrl+Space or clicks suggestion button 3. Suggestion Display Inline suggestions appear below current text Citation previews with source titles and URLs Accept/Reject buttons for each suggestion "Continue writing..." prompts with relevant context Smart Triggers Contextual: "The AI market is growing..." → Suggests statistics Question-based: "What are the benefits of..." → Suggests answers Opinion-based: "I believe that..." → Suggests supporting evidence Implementation Phases Phase 1: Basic Assistant ✅ Toggle switch in header ✅ Basic text continuation suggestions ✅ Simple accept/reject interface ✅ Exa integration for source finding Phase 2: Enhanced Features ✅ Contextual suggestions based on draft content ✅ Citation integration with fact-check system ✅ Multiple suggestion types (continuation, enhancement, citation) ✅ Smart triggering based on content analysis Phase 3: Advanced Intelligence ✅ Learning from user behavior ✅ Industry-specific suggestions ✅ Tone and style matching ✅ Integration with LinkedIn analytics �� Key Benefits For Users Faster writing with intelligent suggestions Better content quality with verified sources Reduced writer's block with contextual prompts Professional credibility with automatic citations
kerem 2026-03-02 23:34:06 +03:00
Author
Owner

@AJaySi commented on GitHub (Sep 8, 2025):

Assistive Writing User Guide

What is Assistive Writing?

Assistive Writing is an AI-powered feature in ALwrity that helps you continue your LinkedIn posts with contextually relevant suggestions. It uses advanced AI to understand what you're writing and provides intelligent continuations based on real-time web research.

How to Use Assistive Writing

1. Enable Assistive Writing

  1. Open the LinkedIn Writer in ALwrity
  2. Look for the "Assistive Writing" toggle switch in the header
  3. Click the toggle to enable the feature (it will turn blue when active)

2. Start Writing

  1. Begin typing your LinkedIn post in the text area
  2. Write at least 5 words to give the AI enough context
  3. Wait 5 seconds after typing - the AI will automatically analyze your content

3. Receive Your First Suggestion

  • After 5 words and 5 seconds, you'll see an "Assistive Writing Suggestion" card appear near your cursor
  • The suggestion includes:
    • Confidence score (how certain the AI is about the suggestion)
    • Suggested text to continue your post
    • Source links for verification and further reading

4. Accept or Dismiss Suggestions

To Accept a Suggestion:

  • Click the "Accept" button
  • The suggested text will be inserted at your cursor position
  • You can continue editing from there

To Dismiss a Suggestion:

  • Click the "Dismiss" button
  • The suggestion will disappear

5. Request More Suggestions

After your first automatic suggestion, the system becomes more conservative to save costs:

  • You'll see a "Continue writing" prompt: "ALwrity can contextually continue writing. Click Continue writing."
  • Click "Continue writing" to get another AI-powered suggestion
  • This manual approach ensures you only get suggestions when you actually want them

Understanding the Suggestions

What Makes a Good Suggestion?

  • Contextually relevant to your topic
  • Professionally written in LinkedIn style
  • Based on real sources from the web
  • Confidence score of 70% or higher

Source Information

Each suggestion includes:

  • Article titles from reputable sources
  • Clickable links to read the full articles
  • Author information when available
  • Publication dates for recency

Best Practices

Do This:

  • Write at least 5 words before expecting suggestions
  • Use specific, clear language in your posts
  • Review source links to verify information
  • Accept suggestions that align with your message
  • Use the manual "Continue writing" button for additional suggestions

Avoid This:

  • Expecting suggestions for very short text (under 5 words)
  • Accepting suggestions without reviewing them
  • Ignoring source links for fact-checking
  • Making rapid changes that might confuse the AI

Troubleshooting

"No suggestions appearing"

  • Check: Have you written at least 5 words?
  • Check: Have you waited 5 seconds after typing?
  • Check: Is Assistive Writing enabled (toggle should be blue)?

"API quota exceeded" error

  • This means the daily limit for AI suggestions has been reached
  • Wait 24 hours for the quota to reset, or upgrade your plan
  • The feature will automatically resume when quota is available

"No relevant sources found"

  • The AI couldn't find good sources for your specific topic
  • Try being more specific in your writing
  • Consider rephrasing to use more common business terms

"Search service not configured"

  • This is a technical configuration issue
  • Contact support for assistance

Cost and Usage

How It Works:

  • First suggestion: Automatic after 5 words + 5 seconds
  • Additional suggestions: Manual only (click "Continue writing")
  • Daily limit: 50 suggestions per day on free tier
  • Cost control: Manual triggering prevents excessive API usage

Why Manual After First Suggestion?

  • Saves costs by not making unnecessary API calls
  • Gives you control over when to get suggestions
  • Prevents overwhelming you with too many options
  • Ensures suggestions are relevant to your current writing

Tips for Better Results

1. Be Specific

Instead of: "AI is changing business"
Try: "AI is transforming customer service with chatbots and predictive analytics"

2. Use Industry Terms

The AI understands business terminology better than casual language

3. Write Complete Thoughts

Instead of: "Marketing is"
Try: "Marketing is evolving rapidly with new digital tools"

4. Review Sources

Always check the provided source links to ensure accuracy

5. Edit as Needed

Accept suggestions as starting points, then edit to match your voice

Privacy and Data

  • Your writing content is processed securely
  • No personal data is stored permanently
  • Suggestions are generated in real-time
  • Source links are from publicly available web content

Support

If you encounter issues:

  1. Check this guide first
  2. Try disabling and re-enabling Assistive Writing
  3. Refresh the page and try again
  4. Contact support with specific error messages

Assistive Writing is designed to enhance your LinkedIn content creation experience while maintaining cost efficiency and user control.

<!-- gh-comment-id:3264404507 --> @AJaySi commented on GitHub (Sep 8, 2025): # Assistive Writing User Guide ## What is Assistive Writing? Assistive Writing is an AI-powered feature in ALwrity that helps you continue your LinkedIn posts with contextually relevant suggestions. It uses advanced AI to understand what you're writing and provides intelligent continuations based on real-time web research. ## How to Use Assistive Writing ### 1. Enable Assistive Writing 1. Open the LinkedIn Writer in ALwrity 2. Look for the **"Assistive Writing"** toggle switch in the header 3. Click the toggle to enable the feature (it will turn blue when active) ### 2. Start Writing 1. Begin typing your LinkedIn post in the text area 2. Write at least **5 words** to give the AI enough context 3. Wait **5 seconds** after typing - the AI will automatically analyze your content ### 3. Receive Your First Suggestion - After 5 words and 5 seconds, you'll see an **"Assistive Writing Suggestion"** card appear near your cursor - The suggestion includes: - **Confidence score** (how certain the AI is about the suggestion) - **Suggested text** to continue your post - **Source links** for verification and further reading ### 4. Accept or Dismiss Suggestions **To Accept a Suggestion:** - Click the **"Accept"** button - The suggested text will be inserted at your cursor position - You can continue editing from there **To Dismiss a Suggestion:** - Click the **"Dismiss"** button - The suggestion will disappear ### 5. Request More Suggestions After your first automatic suggestion, the system becomes more conservative to save costs: - You'll see a **"Continue writing"** prompt: *"ALwrity can contextually continue writing. Click Continue writing."* - Click **"Continue writing"** to get another AI-powered suggestion - This manual approach ensures you only get suggestions when you actually want them ## Understanding the Suggestions ### What Makes a Good Suggestion? - **Contextually relevant** to your topic - **Professionally written** in LinkedIn style - **Based on real sources** from the web - **Confidence score** of 70% or higher ### Source Information Each suggestion includes: - **Article titles** from reputable sources - **Clickable links** to read the full articles - **Author information** when available - **Publication dates** for recency ## Best Practices ### ✅ Do This: - Write at least 5 words before expecting suggestions - Use specific, clear language in your posts - Review source links to verify information - Accept suggestions that align with your message - Use the manual "Continue writing" button for additional suggestions ### ❌ Avoid This: - Expecting suggestions for very short text (under 5 words) - Accepting suggestions without reviewing them - Ignoring source links for fact-checking - Making rapid changes that might confuse the AI ## Troubleshooting ### "No suggestions appearing" - **Check:** Have you written at least 5 words? - **Check:** Have you waited 5 seconds after typing? - **Check:** Is Assistive Writing enabled (toggle should be blue)? ### "API quota exceeded" error - This means the daily limit for AI suggestions has been reached - Wait 24 hours for the quota to reset, or upgrade your plan - The feature will automatically resume when quota is available ### "No relevant sources found" - The AI couldn't find good sources for your specific topic - Try being more specific in your writing - Consider rephrasing to use more common business terms ### "Search service not configured" - This is a technical configuration issue - Contact support for assistance ## Cost and Usage ### How It Works: - **First suggestion:** Automatic after 5 words + 5 seconds - **Additional suggestions:** Manual only (click "Continue writing") - **Daily limit:** 50 suggestions per day on free tier - **Cost control:** Manual triggering prevents excessive API usage ### Why Manual After First Suggestion? - Saves costs by not making unnecessary API calls - Gives you control over when to get suggestions - Prevents overwhelming you with too many options - Ensures suggestions are relevant to your current writing ## Tips for Better Results ### 1. Be Specific Instead of: "AI is changing business" Try: "AI is transforming customer service with chatbots and predictive analytics" ### 2. Use Industry Terms The AI understands business terminology better than casual language ### 3. Write Complete Thoughts Instead of: "Marketing is" Try: "Marketing is evolving rapidly with new digital tools" ### 4. Review Sources Always check the provided source links to ensure accuracy ### 5. Edit as Needed Accept suggestions as starting points, then edit to match your voice ## Privacy and Data - Your writing content is processed securely - No personal data is stored permanently - Suggestions are generated in real-time - Source links are from publicly available web content ## Support If you encounter issues: 1. Check this guide first 2. Try disabling and re-enabling Assistive Writing 3. Refresh the page and try again 4. Contact support with specific error messages --- *Assistive Writing is designed to enhance your LinkedIn content creation experience while maintaining cost efficiency and user control.*
Author
Owner

@AJaySi commented on GitHub (Sep 8, 2025):

Assistive Writing - Quick Reference

🚀 Getting Started

  1. Enable: Toggle "Assistive Writing" in LinkedIn Writer header
  2. Write: Type at least 5 words
  3. Wait: 5 seconds for first automatic suggestion
  4. Accept/Dismiss: Use buttons in suggestion card

📝 How It Works

  • First suggestion: Automatic (5 words + 5 seconds)
  • More suggestions: Click "Continue writing" button
  • Daily limit: 50 suggestions (resets every 24 hours)

🎯 Best Practices

  • Write specific, clear content
  • Review source links before accepting
  • Use manual "Continue writing" for additional suggestions
  • Don't expect suggestions for very short text
  • Don't ignore source verification

🔧 Common Issues

Problem Solution
No suggestions Write 5+ words, wait 5 seconds
"API quota exceeded" Wait 24 hours or upgrade plan
"No relevant sources" Be more specific in your writing
Suggestions not relevant Try different wording or topics

💡 Pro Tips

  • Use business terminology for better results
  • Write complete thoughts, not fragments
  • Check source links for accuracy
  • Edit suggestions to match your voice
  • Use manual triggering to control costs

📞 Need Help?

  • Check the full user guide: ASSISTIVE_WRITING_USER_GUIDE.md
  • Contact support for technical issues
  • Try refreshing the page if problems persist

Quick reference for ALwrity's Assistive Writing feature

<!-- gh-comment-id:3264404884 --> @AJaySi commented on GitHub (Sep 8, 2025): # Assistive Writing - Quick Reference ## 🚀 Getting Started 1. **Enable:** Toggle "Assistive Writing" in LinkedIn Writer header 2. **Write:** Type at least 5 words 3. **Wait:** 5 seconds for first automatic suggestion 4. **Accept/Dismiss:** Use buttons in suggestion card ## 📝 How It Works - **First suggestion:** Automatic (5 words + 5 seconds) - **More suggestions:** Click "Continue writing" button - **Daily limit:** 50 suggestions (resets every 24 hours) ## 🎯 Best Practices - ✅ Write specific, clear content - ✅ Review source links before accepting - ✅ Use manual "Continue writing" for additional suggestions - ❌ Don't expect suggestions for very short text - ❌ Don't ignore source verification ## 🔧 Common Issues | Problem | Solution | |---------|----------| | No suggestions | Write 5+ words, wait 5 seconds | | "API quota exceeded" | Wait 24 hours or upgrade plan | | "No relevant sources" | Be more specific in your writing | | Suggestions not relevant | Try different wording or topics | ## 💡 Pro Tips - Use business terminology for better results - Write complete thoughts, not fragments - Check source links for accuracy - Edit suggestions to match your voice - Use manual triggering to control costs ## 📞 Need Help? - Check the full user guide: `ASSISTIVE_WRITING_USER_GUIDE.md` - Contact support for technical issues - Try refreshing the page if problems persist --- *Quick reference for ALwrity's Assistive Writing feature*
Author
Owner

@AJaySi commented on GitHub (Sep 8, 2025):

Assistive Writing Workflow

Visual Workflow

1. ENABLE ASSISTIVE WRITING
   ┌─────────────────────────┐
   │ Toggle "Assistive       │
   │ Writing" ON (blue)      │
   └─────────────────────────┘
              │
              ▼

2. START WRITING
   ┌─────────────────────────┐
   │ Type at least 5 words   │
   │ in the text area        │
   └─────────────────────────┘
              │
              ▼

3. WAIT FOR AI ANALYSIS
   ┌─────────────────────────┐
   │ Wait 5 seconds          │
   │ AI analyzes your text   │
   └─────────────────────────┘
              │
              ▼

4. RECEIVE FIRST SUGGESTION
   ┌─────────────────────────┐
   │ Suggestion card appears │
   │ near your cursor        │
   │                         │
   │ [Accept] [Dismiss]      │
   └─────────────────────────┘
              │
              ▼

5. AFTER FIRST SUGGESTION
   ┌─────────────────────────┐
   │ "Continue writing"      │
   │ prompt appears          │
   │                         │
   │ [Continue writing]      │
   │ [Dismiss]               │
   └─────────────────────────┘
              │
              ▼

6. MANUAL SUGGESTIONS
   ┌─────────────────────────┐
   │ Click "Continue writing"│
   │ to get more suggestions │
   │ (saves costs)           │
   └─────────────────────────┘

Step-by-Step Process

Phase 1: Initial Setup

  1. Enable Feature → Toggle switch turns blue
  2. Start Writing → Type 5+ words
  3. Wait → 5-second delay for AI processing

Phase 2: First Suggestion

  1. Receive Suggestion → Card appears with:
    • Suggested text
    • Confidence score
    • Source links
    • Accept/Dismiss buttons

Phase 3: Ongoing Usage

  1. Accept or Dismiss → Choose your action
  2. Continue Writing → Manual trigger for more suggestions
  3. Repeat → Use "Continue writing" as needed

Key Points

Automatic vs Manual

  • Automatic: Only the first suggestion (after 5 words + 5 seconds)
  • Manual: All subsequent suggestions (click "Continue writing")

Cost Control

  • Prevents excessive API calls
  • Gives you control over when to get suggestions
  • Respects daily limits (50 suggestions/day)

User Experience

  • Suggestions appear near your cursor
  • Clear accept/dismiss options
  • Source verification available
  • Professional LinkedIn-style content

Error Handling

If you see an error:
┌─────────────────────────┐
│ Check the error message │
│                         │
│ Common errors:          │
│ • "API quota exceeded"  │
│ • "No relevant sources" │
│ • "Service not available"│
└─────────────────────────┘
              │
              ▼
┌─────────────────────────┐
│ Follow troubleshooting  │
│ steps in user guide     │
└─────────────────────────┘

Success Indicators

Working Correctly:

  • Toggle is blue when enabled
  • Suggestions appear after 5 words + 5 seconds
  • Source links are clickable
  • "Continue writing" button appears after first suggestion

Needs Attention:

  • No suggestions after 10+ words
  • Error messages in suggestion cards
  • Toggle not staying blue
  • Suggestions not appearing near cursor

This workflow ensures cost-effective, user-controlled AI assistance for LinkedIn content creation.

<!-- gh-comment-id:3264405317 --> @AJaySi commented on GitHub (Sep 8, 2025): # Assistive Writing Workflow ## Visual Workflow ``` 1. ENABLE ASSISTIVE WRITING ┌─────────────────────────┐ │ Toggle "Assistive │ │ Writing" ON (blue) │ └─────────────────────────┘ │ ▼ 2. START WRITING ┌─────────────────────────┐ │ Type at least 5 words │ │ in the text area │ └─────────────────────────┘ │ ▼ 3. WAIT FOR AI ANALYSIS ┌─────────────────────────┐ │ Wait 5 seconds │ │ AI analyzes your text │ └─────────────────────────┘ │ ▼ 4. RECEIVE FIRST SUGGESTION ┌─────────────────────────┐ │ Suggestion card appears │ │ near your cursor │ │ │ │ [Accept] [Dismiss] │ └─────────────────────────┘ │ ▼ 5. AFTER FIRST SUGGESTION ┌─────────────────────────┐ │ "Continue writing" │ │ prompt appears │ │ │ │ [Continue writing] │ │ [Dismiss] │ └─────────────────────────┘ │ ▼ 6. MANUAL SUGGESTIONS ┌─────────────────────────┐ │ Click "Continue writing"│ │ to get more suggestions │ │ (saves costs) │ └─────────────────────────┘ ``` ## Step-by-Step Process ### Phase 1: Initial Setup 1. **Enable Feature** → Toggle switch turns blue 2. **Start Writing** → Type 5+ words 3. **Wait** → 5-second delay for AI processing ### Phase 2: First Suggestion 4. **Receive Suggestion** → Card appears with: - Suggested text - Confidence score - Source links - Accept/Dismiss buttons ### Phase 3: Ongoing Usage 5. **Accept or Dismiss** → Choose your action 6. **Continue Writing** → Manual trigger for more suggestions 7. **Repeat** → Use "Continue writing" as needed ## Key Points ### Automatic vs Manual - **Automatic:** Only the first suggestion (after 5 words + 5 seconds) - **Manual:** All subsequent suggestions (click "Continue writing") ### Cost Control - Prevents excessive API calls - Gives you control over when to get suggestions - Respects daily limits (50 suggestions/day) ### User Experience - Suggestions appear near your cursor - Clear accept/dismiss options - Source verification available - Professional LinkedIn-style content ## Error Handling ``` If you see an error: ┌─────────────────────────┐ │ Check the error message │ │ │ │ Common errors: │ │ • "API quota exceeded" │ │ • "No relevant sources" │ │ • "Service not available"│ └─────────────────────────┘ │ ▼ ┌─────────────────────────┐ │ Follow troubleshooting │ │ steps in user guide │ └─────────────────────────┘ ``` ## Success Indicators ✅ **Working Correctly:** - Toggle is blue when enabled - Suggestions appear after 5 words + 5 seconds - Source links are clickable - "Continue writing" button appears after first suggestion ❌ **Needs Attention:** - No suggestions after 10+ words - Error messages in suggestion cards - Toggle not staying blue - Suggestions not appearing near cursor --- *This workflow ensures cost-effective, user-controlled AI assistance for LinkedIn content creation.*
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/ALwrity#164
No description provided.