Initial commit

commands/upload.md

@@ -0,0 +1,41 @@
+---
+description: Upload documents to store with caching
+argument-hint: files... --store name
+---
+
+Upload files to a Gemini File Search store with intelligent caching and glob support.
+
+## Usage
+
+```bash
+gemini-file-search-tool upload FILES... --store "STORE_NAME" [OPTIONS]
+```
+
+## Arguments
+
+- `FILES`: File paths or glob patterns (required)
+- `--store NAME`: Target store name (required)
+- `--num-workers N`: Concurrent workers (default: CPU cores)
+- `--no-wait`: Async upload without polling
+- `--rebuild-cache`: Force re-upload all files
+- `-v/-vv/-vvv`: Verbosity levels
+
+## Examples
+
+```bash
+# Upload single file
+gemini-file-search-tool upload document.pdf --store "papers"
+
+# Upload with glob pattern
+gemini-file-search-tool upload "docs/**/*.md" --store "documentation" -v
+
+# Upload codebase for Code-RAG
+gemini-file-search-tool upload "src/**/*.py" --store "my-codebase" -v
+
+# Async upload with 8 workers
+gemini-file-search-tool upload "*.pdf" --store "papers" --no-wait --num-workers 8
+```
+
+## Output
+
+Returns JSON array with upload status for each file (completed, skipped, pending, failed).