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. Files are versioned, governed, and continuously updated from connected sources. They can reference source objects and link to related files. Therefore, agents can follow entity, temporal, semantic, and causal relationships across your context repository.

​
Workspace navigation

Use the sidebar to move between Context, Changes, Sources, and Clients. Open the workspace menu at the top to switch workspaces or select Workspace settings. The Help button beside the user menu opens documentation, support, and recent changelog entries. When the sidebar is collapsed, Help is available inside the user menu.

​
Profile and workspace settings

​
Account settings

Open the user menu and select Account settings to update your first and last name. The email address is shown but cannot be changed there. Select the Picture tile to upload and crop a profile picture. Select Remove to return to initials. The picture also appears in the user menu.

​
Appearance

Open the user menu at the bottom of the sidebar and select Theme to choose Light, Dark, or System. Qontext follows the system appearance by default. The same options are available as visual previews under Appearance in Account settings. The choice is saved in the current browser. Open the workspace menu and select Workspace settings. Select the Logo tile to upload and crop a logo, or select Remove to return to workspace initials. The logo appears in the workspace switcher. Changing the logo requires permission to manage workspace settings.

​
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. 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 logs

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 accessed, trace outputs back to specific context, and identify the most impactful files on AI responses.

​
Creating files

1

Add a new file

In the Context tab, click + next to the folder where you want the file to live, then choose New file. To create a file directly in the workspace root, use New file or folder below the tree and select New file. Storage settings is beside this menu.The General folder’s Add menu with New file and New folder actions
2

Rename it

The new file opens in the editor. Enter its name and confirm with the checkmark, then add your content. Click Save, optionally add a reason, and confirm.Close-up of the editable new-file.md name with confirm and cancel controls

​
Uploading files and folders

Use Upload in the Context tab to add existing Markdown files or folders. Conversion from PDFs and other formats is not yet supported. See File and folder uploads for the steps and limits.

​
Moving and renaming

  • Files: Open File settings to change the file’s Name or Location. Select / as the location to move it to the workspace root.
  • Folders: Select the folder and open Settings to change its Name or Location. Moving a folder also moves everything inside it. Select / as the location to make it a top-level folder.

​
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.Company overview with selected text and the rich-text formatting toolbar
3

Save your changes

Click Save, optionally add a reason, and confirm 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 Qontext app by using the delete action and confirming it. Deletion is permanent.
  • Switch to the raw Markdown editor via the selector at the top right to edit the raw Markdown directly.