`sync`

Upload scanned repository chunks to NotebookLM after explicit approval.

AccessUploads repository chunks

NetworkNotebookLM backend

SourceBuilt-in Clyde command

Syntax#

clyde sync REPO --notebook-id ID --approve-upload [scan flags]

Options#

Flag	Purpose
`--notebook-id`	NotebookLM notebook id.
`--notebook-url`	NotebookLM notebook URL.
`--approve-upload`	Required explicit upload approval.
`--backend`	NotebookLM backend: mcp or nlm.
`--mcp-command`	Command used for MCP backend.
`--nlm-command`	Command used for nlm backend.
`--delete-existing-sources`	With --backend nlm, delete all existing notebook sources first.
`--mcp-timeout`	Seconds to wait for each backend response.
`--status-url`	Optional Clyde daemon JSON-RPC URL.
`--dry-run`	Plan the selected sync without uploading or deleting sources.
`--receipt`	Path for the local sync receipt.
`--resume`	Resume an eligible receipt after checking its bundle.
`--heartbeat-interval`	Seconds between simple status updates during backend work.
`--quiet-progress`	Suppress real-time progress lines.
`--job-id`	Status daemon job id.
`--subject`	Generate a dated NotebookLM book title.
`--book-title`	Use an exact NotebookLM book title.
`--include`	Only include matching globs; repeatable.
`--exclude`	Skip matching globs in addition to defaults; repeatable.
`--exclude-folder`	Skip a folder and its descendants; repeatable.
`--max-file-bytes`	Skip files larger than this many bytes.
`--max-chunk-chars`	Split source text at this many characters.

Arguments#

REPO

Examples#

clyde sync --bundle .clyde/out --notebook-id "your-notebook-id" --dry-run

clyde sync . --notebook-id "your-notebook-id" --approve-upload

clyde sync . --notebook-id nb --approve-upload --backend nlm

clyde sync . --notebook-id nb --approve-upload --status-url http://127.0.0.1:5876/rpc --job-id clyde-sync

Example Use Cases#

Build a reviewed bundle, run sync --dry-run, then approve the exact bundle digest. Use receipt status to inspect a local receipt before resuming an interrupted sync.

Safety Notes#

Clyde is a local workflow harness, not an operating-system sandbox. Review bundles before upload, keep NotebookLM notebooks private, and avoid sending secrets, customer data, production records, tokens, credentials, browser state, or private keys.