gdcli

1# Google Drive CLI
2 
3Command-line interface for Google Drive operations.
4 
5## Installation
6 
7```bash
8npm install -g @mariozechner/gdcli
9```
10 
11## Setup
12 
13### Google Cloud Console (one-time)
14 
151. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing)
162. [Enable the Google Drive API](https://console.cloud.google.com/apis/api/drive.googleapis.com)
173. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding
184. [Add test users](https://console.cloud.google.com/auth/audience) (all Gmail addresses you want to use)
195. [Create OAuth client](https://console.cloud.google.com/auth/clients):
20   - Click "Create Client"
21   - Application type: "Desktop app"
22   - Download the JSON file
23 
24### Configure gdcli
25 
26First check if already configured:
27```bash
28gdcli accounts list
29```
30 
31If no accounts, guide the user through setup:
321. Ask if they have a Google Cloud project with Drive API enabled
332. If not, walk them through the Google Cloud Console steps above
343. Have them download the OAuth credentials JSON
354. Run: `gdcli accounts credentials ~/path/to/credentials.json`
365. Run: `gdcli accounts add <email>` (use `--manual` for browserless OAuth)
37 
38## Usage
39 
40Run `gdcli --help` for full command reference.
41 
42Common operations:
43- `gdcli <email> ls [folderId]` - List files/folders
44- `gdcli <email> ls --query "<query>"` - List with Drive query filter
45- `gdcli <email> search "<text>"` - Full-text content search
46…