scenes

Reference for the scenes tool of Author: scene text, with every action and the arguments you can pass.

Updated 17 October 2026 · View as Markdown

A scene's text, in Markdown. A profile is mentioned as @[Name](profile:<id>).

Call it as geenius_author(tool: "scenes", action: "<action>", args: {...}) through Geenius OS.

Actions#

ActionWhat it does
readA scene's text, its rev and who wrote it last. Rules: scene_id, format? markdown|plain: the text, rev, who wrote it last.
writeReplace a scene's text (Markdown). Rules: scene_id, markdown, expect_rev? (REQUIRED to replace text a person wrote in the app — read it first).
appendAdd Markdown to the end of a scene. Rules: scene_id, markdown.
patchFind and replace inside a scene's text. Rules: scene_id, find, replace, all?, expect_rev?.

Arguments we have checked#

scenes · read#

A scene's text, its rev and who wrote it last. Rules: scene_id, format? markdown|plain: the text, rev, who wrote it last.

  • format
  • scene_id (required)

scenes · write#

Replace a scene's text (Markdown). Rules: scene_id, markdown, expect_rev? (REQUIRED to replace text a person wrote in the app — read it first).

  • expect_rev
  • markdown (required)
  • scene_id (required)

scenes · append#

Add Markdown to the end of a scene. Rules: scene_id, markdown.

  • expect_rev
  • markdown (required)
  • scene_id (required)

scenes · patch#

Find and replace inside a scene's text. Rules: scene_id, find, replace, all?, expect_rev?.

  • all
  • expect_rev
  • find (required)
  • replace (required)
  • scene_id (required)