Agent Chat
The agent reads your open project and answers questions about it. It can create entities, notes, folders, plots and tags for you. It runs on OpenCode, under your own model provider account.
Setting it up
Section titled “Setting it up”In Settings › Plugins, under Chat:
- Install OpenCode. It is a one-time download.
- Sign in to a model provider.
Then open Chat in the project sidebar.
What the agent may write
Section titled “What the agent may write”By default the agent never writes into your text. It suggests changes, and you accept or refuse each one in the chat.
Under Chat, set a level for each kind of document: Manuscript, Notes and Entities.
| Level | The agent may |
|---|---|
| No writing | suggest changes only. This is the default. |
| Edit existing text | change text a document already holds. |
| Write and edit | also fill an empty document. In the manuscript, also add a chapter or scene with its text. |
Before the agent changes a chapter, Scriptorium saves a version of it. See Version history.
If you ask for something a level does not allow, the agent says which one to change.
Web search
Section titled “Web search”Web search is off by default. Turned on, the agent can search the web and read pages. Searches go through Exa, a search service. The change applies to your next new chat.
Reviewing changes
Section titled “Reviewing changes”Each change the agent makes is listed under the conversation.
- opens the page it created or changed.
- Reset undoes that change.
- Reset all undoes every change in the list.
Reset keeps your own edits. If you changed the same paragraph after the agent, that change cannot be reset. The list empties when you start a new chat. The changes stay in your project.
Statistics
Section titled “Statistics”Words the agent writes count as AI words in Writing statistics.