gdrivectl

CLI tool to manage Google Docs permissions in bulk — grant, revoke, audit.

Interactive prompts, dry-run by default, owner protection built in.

Install

pipx (recommended)

pipx install git+https://github.com/TheDarkArtist/gdrivectl.git

pip

git clone https://github.com/TheDarkArtist/gdrivectl.git
cd gdrivectl
python3 -m venv .venv
source .venv/bin/activate
pip install .

Quick Start

# Authenticate (opens browser, one-time)
gdrivectl auth login

# List your Google Docs
gdrivectl list

# Revoke access
gdrivectl revoke              # dry-run
gdrivectl revoke --execute    # for real

That's it. OAuth credentials are bundled — no GCP setup needed.

Commands

Safety

• Dry-run by default — grant/revoke show what would happen without --execute
• Owner protection — your email (auto-detected) is never shown as revocable
• Confirmation prompt — always confirms before executing changes
• Audit log — every grant/revoke run logs results to logs/

How It Works

OAuth client credentials are bundled with the package (this is standard practice for desktop/CLI apps — the client ID identifies the app, not your data). When you run gdrivectl auth login, it opens your browser for Google's consent screen where you authorize the app. Your access token is stored locally at ~/.config/gdrivectl/token.json and never leaves your machine.

License

MIT