gdcli

GitHub

Google Drive 命令行工具,支持文件列表、搜索、上传、下载及分享。提供 OAuth 配置指南与详细查询语法说明,用于自动化管理云存储资源。

gdcli/SKILL.md badlogic/pi-skills

触发场景

需要列出或搜索 Google Drive 文件 执行文件上传或下载操作 配置 Google Drive API 访问权限

安装

npx skills add badlogic/pi-skills --skill gdcli -g -y
更多选项

非标准路径

npx skills add https://github.com/badlogic/pi-skills/tree/main/gdcli -g -y

不安装直接使用

npx skills use badlogic/pi-skills@gdcli

指定 Agent (Claude Code)

npx skills add badlogic/pi-skills --skill gdcli -a claude-code -g -y

安装 repo 全部 skill

npx skills add badlogic/pi-skills --all -g -y

预览 repo 内 skill

npx skills add badlogic/pi-skills --list

SKILL.md

Frontmatter
{
    "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

npm install -g @mariozechner/gdcli

Setup

Google Cloud Console (one-time)

  1. Create a new project (or select existing)
  2. Enable the Google Drive API
  3. Set app name in OAuth branding
  4. Add test users (all Gmail addresses you want to use)
  5. Create OAuth client:
    • Click "Create Client"
    • Application type: "Desktop app"
    • Download the JSON file

Configure gdcli

First check if already configured:

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:

# 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

版本历史

  • 90bb51c 当前 2026-07-25 09:42

同 Skill 集合

browser-tools/SKILL.md
gccli/SKILL.md
gmcli/SKILL.md
transcribe/SKILL.md
vscode/SKILL.md
youtube-transcript/SKILL.md

元信息

文件数
0
版本
90bb51c
Hash
edc2c2ce
收录时间
2026-07-25 09:42

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-17 21:01
浙ICP备14020137号-1