К основному содержанию
скилл CX Codex

gdcli — скилл для Claude Code: работа с Google Drive из терминала

Скилл добавляет CLI для Google Drive прямо в редактор: список файлов, поиск по содержимому, загрузка и скачивание, создание папок, общий доступ. Запускается командами вроде gdcli <email> ls или gdcli <email> search.

MIT 169 установок ★ 2 663 обновлён 2026-06-06

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add badlogic/pi-skills --skill gdcli -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/gdcli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gdcli/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
recipe-create-presentation официальный googleworkspace Скилл recipe-create-presentation для Claude Code и Codex: создаёт презентацию Google Slides из терминала и раздаёт к ней права — без браузера, через агент. CX Codex +1 33 500установок google-drive-automation davepoon Скилл google-drive-automation автоматизирует работу с Google Drive: загружает и скачивает файлы, ищет документы, создаёт папки, делится доступом. Работает через Rube MCP и Composio — нужна активная связь с Google Drive. CX Codex +1 133установок recipe-email-drive-link официальный googleworkspace Скилл recipe-email-drive-link для Claude Code, Codex, Cursor и других ИИ-редакторов автоматизирует отправку ссылок на файлы Google Drive по почте. Находит файл, открывает доступ и отправляет письмо с сообщением — всё в одной цепочке команд. CX Codex +1 32 500установок google-drive-upload davepoon Скилл google-drive-upload для Claude Code отправляет файлы в Google Drive через веб-приложение Google Apps Script. Срабатывает по просьбе сохранить или загрузить файл. CX Codex +1 101установок gws-drive-upload davila7 Команда gws-drive-upload загружает локальные файлы в Google Drive через утилиту gws с автоматическим определением MIME-типа. CX Codex +1 69установок gdrive-access terrylica Скилл gdrive-access даёт агенту доступ к Google Drive через CLI: список файлов, скачивание и синхронизация папок. OAuth-токен берётся из 1Password. CX Codex +1 357установок

Из того же набора8

brave-search Ищет информацию в вебе и извлекает текст страниц в Markdown через официальный Brave Search API без запуска браузера. CX Codex +1 1 400установок youtube-transcript Скилл youtube-transcript для Claude Code загружает текстовую дорожку YouTube-видео и отдаёт её агенту с метками времени. Принимает ID или URL — доступны автоматические и ручные субтитры. CX Codex +1 930установок transcribe Скилл transcribe для Claude Code расшифровывает речь локально на Apple Silicon macOS. WAV обрабатывает напрямую, остальные форматы — через ffmpeg. CX Codex +1 851установок browser-tools Скилл browser-tools подключает агент к Chrome через Chrome DevTools Protocol для навигации, проверки интерфейсов и работы с динамическими страницами. CX Codex +1 479установок gccli Скилл gccli для Claude Code обучает ИИ-агента управлять Google Calendar через консольную утилиту. Агент просматривает календари, создаёт и меняет события, проверяет свободные окна. CX Codex +1 177установок gmcli Скилл gmcli добавляет агенту доступ к Gmail через командную строку. Ищите письма, читайте треды, отправляйте сообщения и работайте с черновиками и ярлыками прямо из кода. CX Codex +1 160установок vscode Скилл учит ИИ-агента открывать наглядные диффы и сравнивать версии файлов в VS Code через встроенный CLI. CX Codex +1 155установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой