Google platform

Workspace for humans; GCP APIs for how decli is built, managed, observed, and improved — recursively.

Two layers

Product layer — Workspace sign-in, Drive packs, Docs/Sheets/Slides, Maps location, Air Quality. Used every day by Mac developers.

Platform layer — Agent, App Hub, Observability, IAM, Storage, Security, Telemetry, and related GCP APIs. How the ecosystem is operated and improved over time.

Primary auth

Google Workspace is the primary path into the web console:

  • Dev: https://decli.lvh.me/auth/signin
  • Prod: https://decli.dev/auth/signin

One OAuth web client lists both redirect URIs. Offline tokens land in ~/.decli/google/tokens.json for CLI Drive/Docs after browser login. Optional restriction: GOOGLE_WORKSPACE_DOMAIN.

# After Workspace sign-in in the browser:
decli google auth
decli google drive-list
decli google doc-create "Recover notes"

Product APIs (user-facing)

APIRole in decli
OAuth / People / userinfoGoogle Workspace primary login (decli.lvh.me + decli.dev)
Google Drive APIEncrypted desk pack upload/list (drive.file)
Google Docs / Sheets / Slides APIsWorkspace documents from CLI after Workspace sign-in
Geocoding + Geolocation APIsDevice fleet places (laptop / mini / iPad)
Air Quality APISession environment AQI metadata for coding + web
Maps / Places (optional)Richer place context and future map UI

Platform APIs (enabled on project decli)

These APIs are key elements of how decli is built, managed, used, maintained, and improved upon — including agent fleets, app topology, security, and observability. Product UI may not call every API on day one; they define the platform contract.

APIRole in the ecosystem
Agent Registry APICatalog and discover agents that participate in the decli fleet
Agent Platform APIRuntime surface for agent lifecycle and orchestration
App Hub APIApplication inventory — map monorepos and services as first-class apps
App Topology APIService dependency graph for desk/recover and ops awareness
App Lifecycle Manager APIDeploy / stage / retire app versions consistently
Cloud API Registry APIGovern which external and internal APIs decli may call
Cloud Trace APIDistributed traces across bridge, API, and web
Cloud Logging APICentral logs for recover, pack, and long-running agents
Cloud Monitoring APISLOs and alerts on desk health and bridge uptime
Observability APIUnified telemetry control plane
Telemetry APIMetrics and event pipelines (pairs with Magenta product analytics)
Compute Engine APIOptional remote workers / bastions (e.g. fleet EC2, not local desk)
Cloud StorageObject storage for packs, artifacts, and agent outputs you own
Dataform APIStructured data pipelines when desk Postgres feeds analytics
Notebooks APIManaged notebook runtimes for research / agent eval loops
Identity and Access Management (IAM) APILeast-privilege service accounts for automation
IAM Connectors APIConnect external IdPs and workload identity
Cloud Identity-Aware Proxy APIProtect admin and agent endpoints without a flat VPN
Security Command Center APISecurity findings over projects that host decli automation
Model Armor APIGuardrails on model I/O as AI providers expand
Network Security APIPolicy for private connectivity of platform services
Network Services APILoad balancing and edge routing for decli.dev surfaces
Cloud Text-to-Speech APIVoice UX for notify / accessibility / agent speak-back

Recursive improvement loop

  1. Use — Mac desk pack/recover; CLI + web sessions with environment meta
  2. Observe — Logging, Monitoring, Trace, Telemetry, Magenta product events
  3. Secure — IAM, IAP, SCC, Network Security, Model Armor
  4. Orchestrate — Agent Registry / Platform, App Hub / Topology / Lifecycle
  5. Store — Cloud Storage for artifacts and optional pack mirrors
  6. Improve — Notebooks / Dataform / agents consume signals → better desk defaults

CLI

decli google apis              # product scopes + API list
decli google environment      # session meta incl. AQI
decli google location seed
bash scripts/google-cloud-setup.sh   # enable core product APIs

Full OAuth redirect and env checklist: repo docs/GOOGLE_CLOUD.md. Destinations that use GCS/Drive: Destinations. Architecture: Architecture.