> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Context Awareness

> How EnConvo understands your screen and provides relevant assistance

export const YouTubePlayer = ({videoId, title = "Video"}) => <Frame>
    <div id={`youtube-player-${videoId}`} style={{
  position: "relative",
  width: "100%",
  paddingBottom: "56.25%",
  borderRadius: "12px",
  overflow: "hidden",
  cursor: "pointer"
}} onClick={() => {
  const container = document.getElementById(`youtube-player-${videoId}`);
  container.innerHTML = `<iframe style="position:absolute;top:0;left:0;width:100%;height:100%;border:none;border-radius:12px" src="https://www.youtube.com/embed/${videoId}?autoplay=1" title="${title}" allow="accelerometer;autoplay;clipboard-write;encrypted-media;gyroscope;picture-in-picture" allowfullscreen></iframe>`;
}}>
      <img src={`https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`} alt={title} style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  objectFit: "cover"
}} />
      <div style={{
  position: "absolute",
  top: "50%",
  left: "50%",
  transform: "translate(-50%, -50%)",
  width: "68px",
  height: "48px",
  backgroundColor: "rgba(255, 0, 0, 0.9)",
  borderRadius: "14px",
  display: "flex",
  alignItems: "center",
  justifyContent: "center"
}}>
        <svg width="24" height="24" viewBox="0 0 24 24" fill="white">
          <path d="M8 5v14l11-7z" />
        </svg>
      </div>
    </div>
  </Frame>;

## Overview

Context Awareness is EnConvo's core technology that enables it to understand what you're working on and provide relevant, intelligent assistance. Instead of asking you to explain your context, EnConvo sees and understands your screen, active applications, and current tasks.

<YouTubePlayer videoId="VKhyKibToAw" title="Context Awareness Overview & Demo" />

## How It Works

EnConvo uses advanced screen analysis to understand:

### 1. Active Application Detection

EnConvo knows which application you're using and adapts its responses accordingly:

| Application | Context Provided                               |
| ----------- | ---------------------------------------------- |
| Web Browser | Current URL, page title, visible content       |
| Code Editor | Programming language, file path,  code content |
| Finder      | Selected files, current directory              |
| Other Apps  | Current window content & Screenshot            |

### 2. More Contextual responses

Based on context, EnConvo can provide more contextual responses:

* Coding? Offers debugging help, documentation lookup, etc.
* Writing? Suggests grammar fixes, tone improvements, etc.
* Browsing? Provides summaries, translations, etc.

## Manual Context Control

<Tip>
  Use `#` prefix to add context to your queries.
</Tip>

### Context Modifiers

Use these prefixes for specific context types:

```
#screen - Include current screen content
#finder - Include current Finder selection
#clipboard - Include clipboard content
#browser - Include current browser tab
#... (and more)
```

## Privacy & Security

<Warning>
  Context data never leaves your Mac without your explicit action. All processing happens locally or through your chosen AI provider only when you submit a query.
</Warning>

### Exclusions

Configure apps or content to exclude from context:

1. Go to Settings → Context Awareness
2. Add applications to the exclusion list

### App-Specific Actions

<AccordionGroup>
  <Accordion title="Web Browsers (Safari, Chrome, Arc)">
    * Summarize current page
    * Translate page content
    * Extract key information
    * Save to knowledge base
  </Accordion>

  <Accordion title="Finder">
    * Describe selected files
    * Organize suggestions
    * Batch rename help
    * Content analysis
  </Accordion>
</AccordionGroup>

## Related Features

<CardGroup cols={2}>
  <Card title="SmartBar" icon="magnifying-glass" href="/features/smartbar">
    Use context in SmartBar queries
  </Card>

  <Card title="OCR Features" icon="text" href="/ai/ocr">
    Extract text from images
  </Card>
</CardGroup>
