Clyde Help

Safety labels and glossary

The same short labels appear across Clyde help so users can distinguish inspection, local output, upload, and deletion before running a command.

Safety labels#

LabelMeaning
Read-onlyInspects local state without writing or uploading.
Writes locallyCreates or updates configuration, bundles, or receipts on this computer.
Uploads repository chunksSends repository content to the selected NotebookLM backend only after explicit approval.
Deletes existing sourcesRemoves NotebookLM sources. This requires the nlm backend and explicit approval.

Terms#

Preview
A read-only report of what Clyde would include and skip.
Bundle
A local review package containing a manifest and source chunks.
Digest
A sha256: identifier bound to one exact bundle and required at upload approval.
Dry run
A backend check and transfer plan with no upload, remote deletion, or receipt write.
Receipt
A local sync record used for inspection and safe resume guidance.
Backend
The local integration Clyde uses to reach NotebookLM.

Normal workflow#

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

Only after reviewing the result should you run the command Clyde prints with the required approval flags.