URL Mentions

URL mentions enable you to incorporate web-based content directly into your Sypha conversation. Simply enter @ followed by any URL, and Sypha accesses the webpage content without requiring any manual copying.

Typing @ in chat followed by a URL (such as @https://example.com) prompts Sypha to retrieve that webpage's content and incorporate it into the context. This functions with documentation sites, GitHub issues, Stack Overflow threads, or any web-based content you wish to cite.

URL mentions are my regular tool when working with external APIs or libraries. Rather than attempting to explain API functionality or copying documentation excerpts, I directly cite the documentation:

I'm trying to implement authentication with this API: @https://api.example.com/docs/auth

Can you help me write the code to get an access token based on these docs?

This provides Sypha with the entire documentation page, granting access to all authentication requirements, endpoints, parameters, and examples. Sypha can subsequently deliver more accurate and thorough assistance grounded in the official documentation.

URL mentions prove especially valuable for citing GitHub issues or discussion threads:

I'm trying to fix this issue in our project: @https://github.com/our-org/our-repo/issues/123

Here's my current implementation: @/src/components/Feature.jsx

What changes do I need to make to address the issue?

This presents Sypha with the full GitHub issue, encompassing the description, comment thread, and any embedded code snippets or screenshots. Sypha can subsequently assist you in developing a solution that directly resolves the reported problem.

When working with external documentation or online resources in the future, consider utilizing URL mentions rather than manually copying content. You'll receive more accurate assistance since Sypha can access the complete webpage context, including formatting, code samples, and contextual information.

How It Works Under the Hood

Here's the behind-the-scenes process when employing URL mentions in your message:

1. Upon message submission, Sypha identifies the @http://... or @https://... pattern within your text

2. The extension initiates a headless browser (Puppeteer) in the background

3. It navigates to the specified URL and awaits complete page loading

4. The browser captures the page content, encompassing text, formatting, and code samples

5. The content undergoes conversion to Markdown format while preserving structural elements

6. This content gets attached to your message using a structured format:

   <url_content url="https://example.com/docs">
   # Example API Documentation
   
   ## Authentication
   
   To authenticate with the API, you need to...
   
   const token = await api.authenticate({
     username: 'user',
     password: 'pass'
   });
   
   [Complete webpage content in Markdown format]
   </url_content>

7. The browser subsequently closes to release resources

8. This enriched message containing the embedded webpage content gets transmitted to the AI

This procedure executes automatically each time you employ URL mentions, granting the AI access to complete webpage content without requiring any manual copying.