Upload

Arguments

• --assistant (required): Assistant name
• --source (required): File path or directory to upload
• --patterns (optional): Comma-separated glob patterns — default: *.md,*.txt,*.pdf,*.docx,*.json
• --exclude (optional): Directories to exclude — default: node_modules,.venv,.git,build,dist
• --metadata (optional): JSON string of additional metadata

Workflow

1. Parse arguments. If missing, list assistants and prompt for selection.
2. Use Glob to preview files. Show count and types.
3. If code files detected: Warn user and automatically filter them out:

   Copy

   ⚠️ Found 50 Python files. Assistant works with documents only — I'll skip the code files.
   Found 25 Markdown and 8 PDF files to upload instead.

4. Confirm with the user before proceeding.
5. Execute:

   bashCopy

   uv run scripts/upload.py \
     --assistant "assistant-name" \
     --source "./docs" \
     --patterns "*.md,*.pdf"

6. Show progress and results. Remind user files are being indexed.

Default Exclusions

node_modules, .venv, venv, .git, build, dist, __pycache__, .next, .cache

Metadata Best Practices

Troubleshooting

No files found — check patterns match file types in directory; verify path exists. Upload failures — check file format is supported; try smaller batches. >100 files — ask user if they want to be more selective; suggest ./docs subdirectory.