cast

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

Updated 17 October 2026 · View as Markdown

The cast: Geenius OS profiles linked to the book as references. The profile stays in the OS; Author reads a synced snapshot.

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

Actions#

ActionWhat it does
listThe book's cast: linked Geenius OS profiles. Rules: book_id.
linkLink a Geenius OS profile to the book's cast. Rules: book_id, profile_id, role? (protagonist|antagonist|supporting|minor|narrator|setting|object|weather|organisation), note?.
unlinkUnlink a profile from the cast. Rules: cast_id, or book_id + profile_id.

Arguments we have checked#

cast · list#

The book's cast: linked Geenius OS profiles. Rules: book_id.

  • book_id (required)

Link a Geenius OS profile to the book's cast. Rules: book_id, profile_id, role? (protagonist|antagonist|supporting|minor|narrator|setting|object|weather|organisation), note?.

  • book_id (required)
  • note
  • profile_id (required)
  • role

Unlink a profile from the cast. Rules: cast_id, or book_id + profile_id.

  • book_id
  • cast_id
  • profile_id