gdcli — скилл для Claude Code: работа с Google Drive из терминала
Скилл добавляет CLI для Google Drive прямо в редактор: список файлов, поиск по содержимому, загрузка и скачивание, создание папок, общий доступ. Запускается командами вроде gdcli <email> ls или gdcli <email> search.
MIT 169 установок ★ 2 663 обновлён 2026-06-06
npx skills add badlogic/pi-skills --skill gdcli -a claude-codeЧто делает gdcli
gdcli оборачивает Google Drive API в набор команд для терминала. После установки и первой настройки (создание OAuth-приложения в Google Cloud Console, одна процедура на аккаунт) агент может листать содержимое папок, искать файлы по названию через ls --query, искать по содержимому через search, скачивать и загружать файлы, создавать папки, делать файлы общедоступными. Данные хранятся в ~/.gdcli/credentials.json и ~/.gdcli/accounts.json.
Установка требует npm и доступа к Google Cloud Console: нужно создать проект, включить Drive API, настроить OAuth (на этапе setup проверяется gdcli accounts list, потом задаётся путь к скачанному JSON и добавляется почта через gdcli accounts add <email>). Если агент работает без браузера, используется флаг --manual.
Полезно различать две команды поиска: search "текст" ищет внутри содержимого файлов (fullText), а ls --query "имя = значение" фильтрует по метаданным (название, тип, дата изменения). Для поиска по имени файла используй именно ls --query, не search.
Какие задачи решает
- искать файлы на Google Drive по названию или метаданным
- скачать файл из Google Drive в проект по ID
- загрузить локальный файл на Google Drive в конкретную папку
- создать новую папку на Google Drive из скрипта или команды агента
- сделать файл общедоступным для публичного доступа
Примеры запросов агенту
- Найди все PDF в моём Drive, которые меняли в январе
- Скачай файл с ID abc123def456 в текущую папку проекта
- Создай папку 'reports' в корне Drive и загрузи туда файл src/report.pdf
Как установить gdcli
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gdcli -a claude-code2Вручную: положить файлы
~/.claude/skills/gdcli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gdcli/
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gdcli -a codex2Вручную: положить файлы
.agents/skills/gdcli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gdcli -a cursor2Вручную: положить файлы
.cursor/skills/gdcli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install badlogic/pi-skills gdcli2Вручную: положить файлы
.github/skills/gdcli/SKILL.md1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gdcli -a gemini-cli2Командой платформы
gemini skills install https://github.com/badlogic/pi-skills --path gdcliВручную: положить файлы
.devin/skills/gdcli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gdcli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gdcli
Как установить gdcli в Claude Code?
Выполни две команды: npx skills add badlogic/pi-skills --skill gdcli -a claude-code, затем открой файл ~/.claude/skills/gdcli/SKILL.md в редакторе. Перед первым использованием зарегистрируй аккаунты в Google Cloud Console и запусти gdcli accounts add <email>.
Что делает gdcli?
Это интерфейс командной строки для Google Drive: агент может через него листать файлы и папки, искать по названию или содержимому, скачивать и загружать, создавать папки, открывать общий доступ. Команды вроде gdcli <email> ls, gdcli <email> search, gdcli <email> upload.
Как правильно искать файлы: через search или ls --query?
Используй search "текст" для полнотекстового поиска внутри содержимого файлов. Для поиска по названию, типу или дате — ls --query "name contains 'report'" или ls --query "modifiedTime > '2024-01-01'".
Исходный текст
SKILL.md · MIT
--- name: gdcli description: Google Drive CLI for listing, searching, uploading, downloading, and sharing files and folders. --- # Google Drive CLI Command-line interface for Google Drive operations. ## Installation ```bash npm install -g @mariozechner/gdcli ``` ## Setup ### Google Cloud Console (one-time) 1. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing) 2. [Enable the Google Drive API](https://console.cloud.google.com/apis/api/drive.googleapis.com) 3. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding 4. [Add test users](https://console.cloud.google.com/auth/audience) (all Gmail addresses you want to use) 5. [Create OAuth client](https://console.cloud.google.com/auth/clients): - Click "Create Client" - Application type: "Desktop app" - Download the JSON file ### Configure gdcli First check if already configured: ```bash gdcli accounts list ``` If no accounts, guide the user through setup: 1. Ask if they have a Google Cloud project with Drive API enabled 2. If not, walk them through the Google Cloud Console steps above 3. Have them download the OAuth credentials JSON 4. Run: `gdcli accounts credentials ~/path/to/credentials.json` 5. Run: `gdcli accounts add <email>` (use `--manual` for browserless OAuth) ## Usage Run `gdcli --help` for full command reference. Common operations: - `gdcli <email> ls [folderId]` - List files/folders - `gdcli <email> ls --query "<query>"` - List with Drive query filter - `gdcli <email> search "<text>"` - Full-text content search - `gdcli <email> download <fileId> [destPath]` - Download a file - `gdcli <email> upload <localPath> [--folder <folderId>]` - Upload a file - `gdcli <email> mkdir <name>` - Create a folder - `gdcli <email> share <fileId> --anyone` - Share publicly ## Search **Two different commands:** - `search "<text>"` - Searches inside file contents (fullText) - `ls --query "<query>"` - Filters by metadata (name, type, date, etc.) **Use `ls --query` for filename searches!** ## Query Syntax (for ls --query) Format: `field operator value`. Combine with `and`/`or`, group with `()`. **Operators:** `=`, `!=`, `contains`, `<`, `>`, `<=`, `>=` **Examples:** ```bash # By filename ls --query "name = 'report.pdf'" # exact match ls --query "name contains 'IMG'" # prefix match # By type ls --query "mimeType = 'application/pdf'" ls --query "mimeType contains 'image/'" ls --query "mimeType = 'application/vnd.google-apps.folder'" # folders # By date ls --query "modifiedTime > '2024-01-01'" # By owner/sharing ls --query "'me' in owners" ls --query "sharedWithMe" # Exclude trash ls --query "trashed = false" # Combined ls --query "name contains 'report' and mimeType = 'application/pdf'" ``` Ref: https://developers.google.com/drive/api/guides/ref-search-terms ## Data Storage - `~/.gdcli/credentials.json` - OAuth client credentials - `~/.gdcli/accounts.json` - Account tokens - `~/.gdcli/downloads/` - Default download location
© badlogic · MIT · badlogic/pi-skills