2.1 KiB
2.1 KiB
Google Gemini File Search CLI Scripts
This directory contains CLI tools for managing Google Gemini File Search stores and documents.
Available Scripts
✅ create-store.ts
Create a new file search store.
Usage:
ts-node create-store.ts --name "My Knowledge Base" --project "customer-support" --environment "production"
Status: Complete
🚧 upload-batch.ts (TO BE IMPLEMENTED)
Batch upload documents to a file search store with progress tracking.
Planned Features:
- Concurrent uploads with configurable batch size
- Progress bar with ETA
- Automatic chunking configuration per file type
- Metadata extraction from file path/name
- Cost estimation before upload
- Operation polling until indexing complete
Usage:
ts-node upload-batch.ts --store "fileSearchStores/abc123" --directory "./docs" --concurrent 5
🚧 query-store.ts (TO BE IMPLEMENTED)
Interactive query tool with citation display.
Planned Features:
- Interactive REPL for queries
- Citation rendering with source links
- Metadata filtering options
- Model selection (Flash vs Pro)
- Export query results
Usage:
ts-node query-store.ts --store "fileSearchStores/abc123"
🚧 cleanup.ts (TO BE IMPLEMENTED)
Delete stores and documents (with safety prompts).
Planned Features:
- List all stores with document counts
- Delete specific store or all stores
- Force delete confirmation prompts
- Dry-run mode
Usage:
ts-node cleanup.ts --store "fileSearchStores/abc123" --force
ts-node cleanup.ts --all --dry-run
Prerequisites
# Install dependencies
npm install @google/genai
# Set API key
export GOOGLE_API_KEY="your-api-key-here"
Development Status
Completed: 1/4 scripts (25%)
Next Steps:
- Implement upload-batch.ts
- Implement query-store.ts
- Implement cleanup.ts
- Add package.json with dependencies and scripts
- Test all scripts end-to-end
Notes
These scripts demonstrate best practices from SKILL.md:
- Operation polling until done: true
- Storage quota calculation (3x multiplier)
- Recommended chunking configurations
- Metadata schema patterns
- Force delete for non-empty stores