Skip to content
ScriptoriumDocumentation
English
Download

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.

In  Settings ›  Plugins, under Chat:

  1. Install OpenCode. It is a one-time download.
  2. Sign in to a model provider.

Then open Chat in the project sidebar.

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.

LevelThe agent may
No writingsuggest changes only. This is the default.
Edit existing textchange text a document already holds.
Write and editalso 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 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.

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.

Words the agent writes count as AI words in Writing statistics.