Skip to main content

​
Overview

A file in Qontext is a structured context object inside your context repository. It captures normalized, shared context about one core entity, for example a customer, product, project, process, or deal context attached to a customer. Files are versioned, governed, and continuously updated from connected sources. They can reference source objects and link to related files, so agents can follow entity, temporal, semantic, and causal relationships across your context repository.

​
Viewing files

Files are available in the Context tab. The context repository is shown as a folder tree. Selecting a file renders its Markdown content in the detail panel. Qontext Viewing Files Files are connected through explicit references between entities, facts, and source objects. This enables:
  • Targeted context: Load the most relevant file first, then follow links only when more context is needed.
  • Graph traversal: Follow entity, temporal, semantic, and causal relationships across files.
  • Single source of truth: Update context once and reuse it across clients, APIs, and workflows without duplicate copies.

​
Retrieval history

Each file includes retrieval logs showing when it was accessed and how.
Logs are scoped to the selected file and include access types such as listed or read. This helps you see what an AI agent actually accessed, trace unexpected outputs back to specific context, and understand how often a file influences AI responses.

​
Creating files

1

Add a new file

In the Context tab, hover over the folder where you want the file to live, open its menu by clicking on the three dots, and select New file.Qontext New File
2

Rename it

The new file opens in the editor. Rename it and add your content, then click Save and submit a commit message to create it.Qontext New File Creation

​
Editing files

1

Select a file

Open the Context tab and select a file from the repository tree.
2

Edit the content

Update content using the formatting toolbar or Markdown shortcuts.Qontext Editor
3

Save your changes

Click Save and submit a commit message to finalize the edit.
Additionally, you can:
  • Rename files directly in the editor by changing the title and confirming the update.
  • Delete a file directly in the editor by using the delete action and confirming it. Deletion is permanent.