How to Run an AI Cloud Drive Agent with OE Runtime

List, organise, and analyse your Google Drive files automatically. OE Runtime connects directly to Drive, inventories your files, identifies what is unorganised, and recommends a folder structure — all from a single YAML file.

The Agent YAML

Create a file called agent.yaml inside a cloud-drives/ directory:

name: Drive Manager
description: Read, write, and organize files in Google Drive
instructions: |
  You are a file organization agent with access to Google Drive.
  Help find, list, organize, and summarize files and folders.
  Always confirm before making any write or delete operations.
  Complete all steps fully before writing your report.
steps:
  - name: List Files
    content: |
      List the 20 most recently modified files and folders in the root of Google Drive.
      Note each file's name, type, size, and last modified date.
  - name: Identify Unorganized Files
    content: |
      From the listed files, identify any files sitting loose in the root that could be moved into folders.
      Group them by type (documents, spreadsheets, images, PDFs, other).
  - name: Report
    content: |
      Produce a Drive summary:
      - Total files and folders found
      - Breakdown by file type
      - List of files that are unorganized in root
      - Recommended folder structure to organize them
connectors:
  - connection_name: My Google Drive
    connection_type: google-drive

The Config File

Create oe-config.json in the same directory:

{
  "llm": {
    "provider": "openai",
    "model": "gpt-4o",
    "apiKey": "YOUR_OPENAI_API_KEY"
  },
  "server": {
    "enabled": false,
    "port": 3333,
    "apiKey": "your-secret-api-key"
  },
  "connectors": [
    {
      "connection_name": "My Google Drive",
      "connection_type": "google-drive",
      "clientId": "YOUR_GOOGLE_CLIENT_ID",
      "clientSecret": "YOUR_GOOGLE_CLIENT_SECRET",
      "refreshToken": "YOUR_GOOGLE_REFRESH_TOKEN"
    }
  ]
}

Create OAuth 2.0 credentials at console.cloud.google.com. Enable the Google Drive API, then generate a refresh token using your preferred OAuth flow.

Download OE Runtime

Run the Agent

Windows

# Run the agent
oe-runtime-win.exe cloud-drives/agent.yaml --config cloud-drives/oe-config.json

macOS

# Make executable (first time only)
chmod +x oe-runtime-macos

# Run the agent
oe-runtime-macos cloud-drives/agent.yaml --config cloud-drives/oe-config.json

Linux

# Make executable (first time only)
chmod +x oe-runtime-linux

# Run the agent
oe-runtime-linux cloud-drives/agent.yaml --config cloud-drives/oe-config.json

Running as an API Server

Add --serve to start OE Runtime as an HTTP server on port 3333:

oe-runtime-win.exe --serve --config cloud-drives/oe-config.json

Then send a request:

curl -X POST http://localhost:3333/run \
  -H "Content-Type: application/json" \
  -d '{"yaml": "cloud-drives/agent.yaml", "params": {}}'

Or import the Postman collection (download above) to test all endpoints visually.

Use Cases

• Drive cleanup automation — Automatically inventory your Google Drive root and identify files that are sitting loose without any folder structure. The agent groups them by type and recommends a logical folder hierarchy so you can organise years of accumulated files in minutes.
• Document discovery — Search across hundreds of Drive files to locate a specific document, contract, or report without manually scrolling through folders. The agent reads file names, types, and modification dates to surface exactly what you need.
• Team Drive auditing — List and analyse the contents of a shared team Drive to understand what files exist, how large they are, and when they were last updated. Useful for IT teams managing storage quotas or preparing for data migrations.
• Knowledge base maintenance — Regularly audit your company knowledge base in Drive to identify outdated documents, duplicate files, and missing categories. The agent surfaces files that have not been modified in over 90 days as candidates for archiving or deletion.
• Onboarding document delivery — Locate and summarise the most relevant onboarding guides, policies, and wikis for new team members from a shared Drive. The agent reads the content and delivers a personalised summary without the new hire needing Drive access initially.
• Contract management — Scan a contracts folder to list all agreements, their file dates, and sizes so you can track what is on file. Combine with the OCR agent to extract expiry dates and key clauses from each document automatically.
• Automated backup reporting — Run the agent on a schedule to verify that expected backup files are present in a designated Drive folder. If files are missing or older than expected, the agent flags them in a report for review.
• Storage cost management — Identify the largest files consuming Drive storage and flag them for review or compression. For teams on paid Google Workspace plans, regular storage audits can significantly reduce monthly costs.