// Docs
"Connectors: Google Drive".
Connectors bridge your cloud documents into your clone's workspace. The first one is Google Drive. It ships as a separate plugin, klyr-connectors, and is not installed by default: you add it when you want it.
It works on two levels, and the difference matters.
Level 1: memory sync (read-only)
The Drive folders you choose are mirrored into your workspace as markdown, continuously. Your clone reads them like any other note: your Docs become part of its memory.
This channel is read-only by construction. It signs in to Google with a read-only permission, so it cannot modify anything in your Drive, ever. Not a promise, a technical impossibility.
Two rules keep the mirror healthy:
- The mirror keeps your Drive folder structure exactly as it is. Nobody reorganizes it, not you, not your clone.
- Do not open mirrored
.mdfiles in Google Docs. Drive duplicates the file the moment you do, and the copies then drift apart silently.
Level 2: deferred co-authoring (explicit writes)
You and your clone work on the local markdown copy together, each in your own medium. When you decide a Google Doc should be updated, you say so, and an explicit push rewrites the same Doc in place: same link, same sharing, same document your colleagues already have.
Nothing is ever written to Drive automatically. Your saying "push it" is the trigger, and before anything runs, your clone shows you which document it will touch and a summary of what changes. Publishing a brand-new document from your workspace to Drive works the same way: explicit, confirmed, never a surprise.
Conflicts: nobody wins silently
If you edited the Doc in Google and your clone edited the local copy, neither version overwrites the other. The connector flags the conflict, your clone reads both versions and proposes a merge, and you decide. Auto-overwrite does not exist here.
Consent, exactly scoped
You list exactly which Drive folders are mirrored. Only those folders are ever read. Nothing else in your Drive is visible to Klyr, and you can change the list anytime.
The commands
| Command | What it does |
|---|---|
/klyr-connectors:setup | One-time guided setup: sign-in, choose folders, health check |
/klyr-connectors:pull | Mirror your chosen folders now, flag any conflicts |
/klyr-connectors:push | Update a Doc in place, or publish a new one, with confirmation |
/klyr-connectors:status | Per-file state: clean, edited locally, changed on Drive, or conflict |
One honest limit for now: Google Sheets mirror as read-only data and Google Slides are skipped. Docs are the focus.