canvascoding/canvas-notebook / seed_skills/gdcli
gdcli
VerifiedGoogle Drive CLI for listing, searching, uploading, downloading, and sharing files and folders. Triggers: Google Drive, upload to Drive, download from Drive, share Drive file, find file on Drive, Drive folder, Drive search, gdcli.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| agents/canvas.yaml | config | 196 B |
SKILL.md
View on GitHub---
name: gdcli
description: "Google Drive CLI for listing, searching, uploading, downloading, and sharing files and folders. Triggers: Google Drive, upload to Drive, download from Drive, share Drive file, find file on Drive, Drive folder, Drive search, gdcli."
compatibility: Requires Google OAuth credentials configured via gdcli setup
allowed-tools: Bash(gdcli:*)
metadata:
version: "1.0"
author: canvas-studios
---
# Google Drive CLI
Command-line interface for Google Drive operations.
## Installation
In Canvas Notebook Docker, a container admin installs this once:
```bash
npm install -g @mariozechner/gdcli
```
Check if installed:
```bash
gdcli --help
```
## 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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |