Keeping a copy of what Muninn holds in a place you control: a GitHub repository, or a folder in your own Google Drive.
Start the connection flow for a mirror provider. Returns a URL for the user to open in their browser. After approving, call muninn_mirror_status to confirm. provider: 'github' (two-way sync) or 'gdrive' (push-only).
| Parameter | Type | Required | Description |
|---|---|---|---|
| provider | stringgithub · gdrive | Required | The mirror provider to connect: 'github' for GitHub App (two-way), 'gdrive' for Google Drive (push-only) |
Designate (or un-designate) a bundle for mirroring to a provider. Adds/removes the 'github-mirror' tag on the bundle root's backing memory for GitHub, or 'gdrive-mirror' for Drive. After designating, writes to that bundle automatically enqueue a mirror push. Use muninn_mirror_push to force one now.
| Parameter | Type | Required | Description |
|---|---|---|---|
| rootKey | string | Required | node_key of the bundle root to designate |
| provider | stringgithub · gdrive | Required | Which provider to designate for |
| enabled | boolean | default true | true = designate; false = stop mirroring this bundle |
Force an immediate mirror push of one bundle. Marks the bundle dirty so the next cron tick (every 15 min) pushes it. If provider is omitted, queues for all connected providers.
| Parameter | Type | Required | Description |
|---|---|---|---|
| rootKey | string | Required | node_key of the bundle root to push |
| provider | stringgithub · gdrive | — | Which provider to push to. Omit for all connected providers. |
Manually trigger a mirror reconciliation pass: enqueues every memory the mirror has never seen and re-marks any that changed since their last push, so both re-push on the next cron tick. Useful after a gap or error. Returns enqueuedNew, markedDirty, scanned, and complete (false = the scan stopped on budget and resumes next run).
| Parameter | Type | Required | Description |
|---|---|---|---|
| provider | stringgithub · gdrive | — | Reconcile only this provider. Omit for all connected providers. |
Report mirror connection state and push health per provider. Shows connected, last push time, pending count, and last error. Pass provider to filter to one provider.
| Parameter | Type | Required | Description |
|---|---|---|---|
| provider | stringgithub · gdrive | — | Which provider to check. Omit for all. |