searching-documents-with-google-drive

# Google Drive Document Access

## Overview

Search for and download documents from Google Drive using rclone. Google Docs are automatically exported as Markdown for easy reading and processing.

Scripts are located at `.claude/searching-documents-with-google-drive/gdrive/scripts/`.

**Reference Documentation:**
- [scripts/](scripts/) — Shell scripts for search, download, and sync operations
- [digital-science-reference.md](digital-science-reference.md) — Digital Science documentation links

**Authentication:** See the Authentication section in [digital-science-reference.md](digital-science-reference.md) for rclone setup. The remote must be named `gdrive`.

## Quick Start

```bash
# Check rclone is configured
./scripts/check_rclone.sh

# Search for files
./scripts/search_gdrive.sh "meeting notes"

# Search shared files
./scripts/search_gdrive.sh "standup" --shared

# Download a file (exports Google Docs as Markdown)
./scripts/download_gdrive.sh "Documents/Report" ./output

# Download by file ID
./scripts/download_gdrive.sh --id "FILE_ID" ./output

# Download matching shared files
./scripts/download_gdrive.sh --shared --include "pattern*" ./output
```

## Common Tasks

| Task | Command |
|------|---------|
| Check setup | `./scripts/check_rclone.sh` |
| Search files | `./scripts/search_gdrive.sh "pattern"` |
| Search shared files | `./scripts/search_gdrive.sh "pattern" --shared` |
| Download file | `./scripts/download_gdrive.sh "path/to/file" ./output` |
| Download by ID | `./scripts/download_gdrive.sh --id "FILE_ID" ./output` |
| Download folder | `./scripts/download_gdrive.sh "Folder" ./output --bulk` |
| Download shared files | `./scripts/download_gdrive.sh --shared --include "pattern*" ./output` |
| Limit downloads | `./scripts/download_gdrive.sh --shared --include "pattern*" ./output --limit 20` |

## Export Formats

Google Docs can be exported in different formats:

| Format | Flag | Use Case |
|--------|------|----------|
| Markdown | `--format md` (default) |