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

# Context Mangaer

> How to control Hunch behavior using context

Create context files and folders to guide and control Hunch's behavior. Use these files by mentioning them with the @ symbol in the chat, or selecting from the "Add context" button.

<img src="https://mintcdn.com/hunch-ac9ddd82/HjVSL8mgxMQv8Txo/public/images/context-manager-page.png?fit=max&auto=format&n=HjVSL8mgxMQv8Txo&q=85&s=1acd21f92a420e7237e798f7f4577063" alt="Context Manager Overview" width="3420" height="1964" data-path="public/images/context-manager-page.png" />

## What are Context Files?

Each context file contains a free text editor where you can write down information about your data sources, tables, product features, business specifications, and anything else you think is relevant for Hunch to accurately answer your questions.

<img src="https://mintcdn.com/hunch-ac9ddd82/HjVSL8mgxMQv8Txo/public/images/context-file.png?fit=max&auto=format&n=HjVSL8mgxMQv8Txo&q=85&s=04f4031e881e17b729eba04fa7df73ab" alt="Context File Example" width="3420" height="1964" data-path="public/images/context-file.png" />

## How to Tag Context Files in Chat

Once you've created context files, you can reference them in two ways:

1. **@ Symbol**: Type @ in the chat and select the context file you want to include
2. **Add Context Button**: Click the "Add context" button and select from your available context files

<img src="https://mintcdn.com/hunch-ac9ddd82/8-JWcEs7ZydEJuN2/public/images/start-chat-how-to-tag-context-file.png?fit=max&auto=format&n=8-JWcEs7ZydEJuN2&q=85&s=b3f90c2384c52a3bc2f54a30c7badb5d" alt="How to Tag Context Files" width="3420" height="1964" data-path="public/images/start-chat-how-to-tag-context-file.png" />

## Organizing Your Context

We recommend structuring your context by domains. Create directories for marketing, product, sales, or by areas of your product such as billing, onboarding, or main features.

## Context File Modes

Each context file has three modes that control when Hunch uses the information:

* **Always** - For every question, Hunch will take the content into account while providing the answer
* **Smart** - Hunch will dynamically analyze if the file content is relevant for the user's question
* **When mentioned** - Hunch will take the content into account only if the user explicitly mentions the file using the @ symbol or "Add context" button during the chat

<img src="https://mintcdn.com/hunch-ac9ddd82/HjVSL8mgxMQv8Txo/public/images/file-context-use-mode.png?fit=max&auto=format&n=HjVSL8mgxMQv8Txo&q=85&s=b92a801bc65e0d5bfeeb3bfc956270e6" alt="context file modes" width="3420" height="1964" data-path="public/images/file-context-use-mode.png" />

## Adding Tables to Context Files

To ground context files, you can tag the tables that are relevant for that piece of information. For example, for a marketing context file, you can tag the marketing tables available. Hunch will prioritize using the tagged tables before exploring additional data.

<iframe src="https://www.veed.io/embed/ed8eacb2-290e-418e-8936-b3e46e9ce0e4?watermark=0&color=&sharing=0&title=0&autoplay=1" width="800" height="450" frameborder="0" title="Docs/Context Memory /File context add tables" webkitallowfullscreen mozallowfullscreen allowfullscreen />
