How this block works
Each block card has a How this block works row. Open it to read the block’s steps in ordinary paragraphs and lists. A trigger’s card has the same row, How this trigger works. The agent writes this outline from the block’s code and keeps it current with every change. Because the outline lives in the code, it always describes what the block actually does.- A step that has more detail shows its summary first. Expand it to read the rest.
- When a block’s outline has several steps, Contents lists them so you can jump to one.
- Names of blocks and integrations show as tags you can click.
Commenting on a script
You never edit the outline directly. Instead, you comment on it, and the agent makes the change in the code and the outline together.1
Select the text
Select text in a block’s outline, its title or description, the script description, or a Markdown block. A Comment button appears under the selection.
2
Write your comment
Click Comment, then write a question or the change you want: “Skip leads that already replied”, or “Why does this wait two days?”. Press Enter to add it.
3
Add more, then send
Add as many comments as you like, from any script. They collect above the message box as “N comments, sent with your next message”. Send a message, or send the comments on their own.
- Point at the comment chip to see the queued comments by block. Click Review all to edit or delete them before sending.
- A comment whose quoted text has changed since you wrote it is marked Changed.
Commenting on a script needs edit access (Can edit) to its workspace.
Commenting on outputs and files
The same comments work on what a script produces and on the files you open. Select text to comment on:- Markdown files, code, and plain text
- Word documents and PowerPoint decks
- A block’s Timeline
- Messages in the chat
Every comment joins the same queue, so one message can carry comments on the outline, an output, and a chat reply together.
History
Script.it saves a version of the script at the end of every agent turn that changes it, and when you change it in the app. History lets you see what each version changed and go back to one. To open it, click the history button beside Run in the script header, or choose Show script history from the script’s ⋮ menu. History lists the versions that changed the script’s explanation, newest first, grouped by day. Each version shows:- When it was saved, and who saved it (You for your own changes)
- How many changes it made
- Which blocks it changed
Restoring a version
Click Restore version on the version you’re viewing, then confirm with Restore this version. The restore is saved as a new version, so nothing in history is lost.
Teammates get the restored version when their workspace syncs. If a restore fails for a technical reason, Script.it asks the agent to restore the version in the chat instead.
Restore version needs edit access. It isn’t available while the script has unsaved changes or the agent is working on it.