Reference URL Context
Add reference links when creating tasks to help AI generate more accurate, context-specific breakdowns. AI reads the URLs and incorporates content into steps.
Overview
Reference URLs allow:
- 📎 Paste links to relevant docs, guides, or resources
- 🤖 AI reads URL content before generating breakdown
- ✅ Get steps tailored to specific documentation or requirements
- 🎯 More accurate breakdowns based on actual source material
Best for tasks with:
- Technical implementation from docs
- Following specific guides or RFCs
- Tasks requiring particular methodology
- Reference to specific resources
Without Reference URLs
You: "Implement Stripe checkout"
AI: Generic Stripe integration steps
Result: May not match current Stripe API version
AI generates from:
- General Stripe knowledge
- Common patterns
- May be outdated
With Reference URLs (Premium Feature)
You: "Implement Stripe checkout"
URLs: docs.stripe.com/payments/checkout/how-checkout-works
AI: Reads Stripe docs for current API
AI: Generates steps matching official documentation
Result: Accurate steps for latest Stripe Checkout
AI:
- Reads provided URL content
- Understands current API structure
- Incorporates specific endpoints and methods
- Generates implementation steps matching docs
Result: Steps aligned with actual documentation, not generic implementation.
When Creating Task
- Type your task in input field
- Click Link icon (🔗) next to input
- URL panel opens below input
- Paste URL in the field (auto-detects and adds on paste)
- Add more URLs (up to 10 max)
- Generate task - AI reads URLs first
Visual feedback:
- Link icon turns indigo when URLs added
- Number badge shows URL count
- URLs display as teal chips with domain name
When Regenerating
- Open task detail sheet
- Click "Regenerate"
- Modal shows existing URLs (if any)
- Add/remove URLs as needed
- Click "Regenerate" - AI re-reads URLs
Multiple URLs
Can add up to 10 URLs:
- Mix different sources
- Different sections of same doc
- Complementary resources
Example:
Task: "Implement OAuth 2.0 auth"
URLs:
- oauth.net/2/
- auth0.com/docs/authenticate/protocols/oauth
AI synthesizes from all 3 sources.
What AI Can Read
✅ Supported:
- Public web pages (HTML)
- Documentation sites
- Blog posts and articles
- Public wikis
❌ Not Supported:
- Paywalled content
- Login-required pages
- PDF files
- Video content
- Dynamic/JavaScript-rendered content (partially)
URL Limit
Maximum: 10 URLs per task
Why limit:
- AI context window constraints
- Processing time (more URLs = slower)
- Quality over quantity
Tip: Choose most relevant URLs rather than adding everything.
Processing
AI extracts:
- Main content text
- Code examples
- Step-by-step instructions
- Requirements and specifications
AI ignores:
- Ads and navigation
- Comments sections
- Unrelated sidebar content
Free Tier
Reference URLs:
- 1 use per day (resets midnight UTC)
- Shared quota with Web Research (1 enhanced feature/day total)
- Must choose: URLs OR Research per day
Example:
- Monday: Use Reference URLs → Research locked for the day
- Tuesday: Use Web Research → URLs locked for the day
Premium
Reference URLs:
- ✅ Unlimited uses per day
- ✅ Combine with Web Research
- ✅ Add URLs to every task if needed
- ✅ Never locked
Value: If you do technical/documentation-based work daily, Premium ($35 lifetime) removes limits.
✅ Use Reference URLs When:
Technical Implementation:
- Following API documentation
- Implementing from RFC/specification
- Using framework-specific guides
Official Processes:
- Government forms and requirements
- Compliance procedures
- Regulated workflows
Specific Methodologies:
- Following tutorial step-by-step
- Implementing design pattern from article
- Using specific tool's documentation
Complex Requirements:
- Multi-page documentation
- Detailed specifications
- Particular standards or protocols
❌ Don't Use URLs When:
Task is Self-Contained:
- Personal organization
- Generic workflows
- Common knowledge tasks
URLs Won't Help:
- Vague blog posts
- Opinion pieces
- Unrelated documentation
AI Can Handle Without:
- Simple, standard tasks
- Well-known processes
- Basic implementations
Only add URLs when they genuinely improve breakdown quality.
Adding URLs
Method 1: Paste
- Click URL panel to open
- Paste URL
- Auto-adds on paste
- Displays as chip
Method 2: Type
- Type or paste URL in field
- Press Enter
- Validates and adds
Bulk paste:
- Paste multiple URLs separated by newlines
- All valid URLs add automatically
Removing URLs
Click X on any URL chip to remove it.
Editing URLs
No direct edit - remove and re-add corrected version.
Before Adding
- Link icon (🔗) gray
- No badge shown
After Adding
- Link icon turns indigo
- Number badge shows count (e.g., "3")
- URL chips display below (teal pills)
On Generated Task
Source badge shows:
- 📎 icon if URLs were used
- Indicates task used reference documentation
How many URLs should I add?
Usually 2-4. Official docs + getting started guide + API reference = good coverage. Quality > quantity.
Can AI read PDFs?
No. Only HTML web pages. If doc is PDF-only, describe key points in task notes instead.
What if URL is behind login?
Won't work. AI can only read public pages. Use public docs or describe requirements in notes.
Can I add same URL to multiple tasks?
Yes. Each task's URLs are independent. Common to reuse docs.stripe.com for all Stripe tasks.
Does HealUp store URL content?
Temporarily for regeneration. Not permanently archived. Only URL list and metadata saved long-term.
Can I see what AI extracted from URLs?
Not currently. Source badge confirms URLs were used. Content preview coming in future update.
Comparison: Web Research vs Reference URLs
| Feature | Web Research | Reference URLs |
|---|---|---|
| What | AI searches Google | You provide specific links |
| Control | AI decides queries | You choose sources |
| Best for | Current info, finding resources | Specific docs, known sources |
| Quality | Variable (depends on search) | High (you control source) |
| Quota | 1/day free (shared) | 1/day free (shared) |
| Use when | Don't know best sources | Have specific docs to follow |
Can combine both (Premium only) for maximum context.
Related Guides
- AI Task Breakdown Overview - How AI generation works
- AI Web Research - Let AI find sources
- Detail Level Selector - Control step granularity
- Free vs Premium - Unlock unlimited URLs
Ready to supercharge breakdowns with reference docs?
Open HealUp → and add URLs to your next documentation-based task.