@ Mentions Overview

Among Sypha's most valuable capabilities, @ mentions enable you to effortlessly incorporate external context into your interactions. Rather than manually copying and pasting code snippets, error outputs, or documentation, you can reference them directly using the @ symbol.

Typing @ in the chat field triggers a dropdown menu displaying the available mention options. Through these mentions, you can directly reference files, directories, problems, terminal outputs, git modifications, and web-based content within your conversations.

Available @ Mentions

Multiple mention types are supported by Sypha, each tailored to incorporate distinct kinds of context into your interactions:

Why @ Mentions Matter

@ mentions revolutionize your interaction with Sypha through:

1. Removing copy-paste overhead: Eliminates the need to manually copy code, error outputs, or terminal results. Simply reference them directly.

2. Retaining complete context: Sypha accesses the full context, including import statements, associated functions, and relevant surrounding code.

3. Keeping formatting intact: Terminal results, diagnostic messages, and web-based content preserve their original formatting for better comprehension.

4. Facilitating sophisticated workflows: Merge multiple @ mentions to provide Sypha with comprehensive insight into your challenge:

   I'm getting these errors: @problems
   
   Here's my component: @/src/components/Form.jsx
   And the API endpoint: @/src/api/users.js
   
   The error happens when I submit: @terminal
   
   I think this commit might have caused it: @a1b2c3d

Getting Started

Using @ mentions involves these steps:

1. Enter @ in the chat field
2. Choose the mention type from the dropdown or keep typing
3. For files and directories, browse through your workspace hierarchy
4. Submit your message normally

Sypha automatically handles the mentions and incorporates the referenced content into the context provided to the AI.

Experiment with @ mentions in your upcoming Sypha conversation - you'll discover how significantly more productive and powerful your interactions become when external context can be seamlessly integrated.

How It Works Under the Hood

A sophisticated procedure unfolds behind the scenes whenever you employ @ mentions in your messages:

1. Detection: Upon message submission, Sypha analyzes the text for @ mention patterns through regular expressions

2. Processing: For every identified mention, Sypha performs:

   • Identification of the mention category (file, folder, problems, terminal, git, URL)
   • Retrieval of the associated content (file data, terminal results, etc.)
   • Appropriate formatting of the content

3. Enhancement: Your original message gets enriched with structured information:

   Your original message with @/path/to/file
   
   <file_content path="/path/to/file">
   [Complete file content]
   </file_content>

4. Context Inclusion: The enriched message containing all embedded content gets transmitted to the AI model

5. Seamless Response: The AI now accesses all referenced content as though you had manually copied and inserted it

This complete procedure executes automatically and transparently each time you utilize @ mentions, providing the AI with full context while eliminating manual copying.

Individual @ mention types have unique implementation specifics, detailed in their corresponding documentation pages.