user-files

name	user-files
description	Search and read user's uploaded files (PDFs, markdown, images, documents)
when_to_use	When the user asks about their files, documents, or wants to find/summarize content from uploaded materials
allowed_tools	["files"]

User Files Access

You have access to the user's uploaded files stored in /files/. These can include:

• PDF documents
• Markdown files (.md)
• Text files (.txt)
• Word documents (.docx)
• Images (PNG, JPG, GIF, WebP)

How to access files

Use the files tool with these commands:

Search files semantically

files(command="search", query="your search query", path="/files/")

This performs semantic search across all uploaded files. Use natural language queries.

List files in a folder

files(command="list", path="/files/")
files(command="list", path="/files/subfolder/")

Read a specific file

files(command="read", path="/files/document.md")

Tips

1. Start with search - If the user asks about a topic, search first to find relevant files
2. Check file types - The search results include metadata with mime_type
3. For images - You can describe what's in an image path but cannot view images directly
4. Folder structure - Users can organize files in folders, use list to explore

Example queries

• "What did that PDF say about quarterly results?" → Search for "quarterly results" in /files/
• "Summarize my notes on machine learning" → Search for "machine learning" then read matching files
• "What files do I have?" → List /files/