by 运行时依赖
版本
Initial release of porteden-drive—secure, feature-rich Google Drive management CLI. - List, search, upload, create folders, rename, move, share, and manage permissions on Google Drive using CLI. - Supports both browser-based and token-based authentication, with credentials stored securely. - Uses provider-prefixed file IDs and allows advanced JSON/compact output for AI integrations. - Includes granular filtering: by folder, MIME type, name, shared status, and date modified. - Shares files with users, domains, or publicly; can manage permissions and view/download links. - Offers robust environment variable support and system keyring integration for credential persistence.
安装命令
点击复制技能文档
Use porteden drive for Google Drive file and folder management. Use -jc flags for AI-optimized output.
If porteden is not installed: brew install porteden/tap/porteden (or go install github.com/porteden/cli/cmd/porteden@latest).
Setup (once)
- Browser login (recommended):
porteden auth login— opens browser, credentials stored in system keyring - Direct token:
porteden auth login --token— stored in system keyring - Verify:
porteden auth status - If
PE_API_KEYis set in the environment, the CLI uses it automatically (no login needed). - Drive access requires a token with
driveAccessEnabled: trueand a connected Google account with Drive scopes.
Drive commands (porteden drive)
- List files:
porteden drive files -jc - Search by keyword:
porteden drive files -q "budget report" -jc - Filter by folder:
porteden drive files --folder google:0B7_FOLDER_ID -jc - Filter by MIME type:
porteden drive files --mime-type application/pdf -jc - Filter by name:
porteden drive files --name "Q1" -jc - Shared with me:
porteden drive files --shared-with-me -jc - Modified in range:
porteden drive files --modified-after 2026-01-01 --modified-before 2026-02-01 -jc - All files (auto-paginate):
porteden drive files --all -jc - Get file metadata:
porteden drive file google:FILEID -jc - Get view/download links:
porteden drive download google:FILEID -jc - List permissions:
porteden drive permissions google:FILEID -jc - Upload file:
porteden drive upload --file ./report.pdf --name "Q1 Report.pdf" - Upload to folder:
porteden drive upload --file ./data.csv --name "Data.csv" --folder google:0B7_FOLDER - Create folder:
porteden drive mkdir --name "Project Files" - Create folder in folder:
porteden drive mkdir --name "Reports" --parent google:0B7_FOLDER - Rename:
porteden drive rename google:FILEID --name "New Name.pdf" - Move:
porteden drive move google:FILEID --destination google:0B7_DEST_FOLDER - Share with user:
porteden drive share google:FILEID --type user --role reader --email user@example.com - Share with domain:
porteden drive share google:FILEID --type domain --role reader --domain example.com - Share publicly:
porteden drive share google:FILEID --type anyone --role reader - Delete (trash):
porteden drive delete google:FILEID(prompts) orporteden drive delete google:FILEID -y
Notes
- Credentials persist in the system keyring after login. No repeated auth needed.
- Set
PE_PROFILE=workto avoid repeating--profile. -jcis shorthand for--json --compact: strips noise, limits fields, reduces tokens for AI agents.- File IDs are always provider-prefixed (e.g.,
google:1BxiMVs0XRA5...). Pass them as-is. porteden drive files --allauto-paginates (safety cap: 50 pages). CheckhasMorein JSON output.porteden drive downloadreturns URLs only — no binary content is streamed.accessInfoin responses describes active token restrictions. Always check it to understand what data may be limited.authWarningsin list responses indicate provider connection issues.deletemoves to trash (reversible). Files can be restored from Google Drive trash.- Confirm before sharing or deleting files.
- Environment variables:
PE_API_KEY,PE_PROFILE,PE_FORMAT,PE_COLOR,PE_VERBOSE.