Agent Tools

Your Game Master and assistant (Orbit) can each use a handful of actions while they reply. Knowing what those actions are helps you understand what they can do — and what might happen when they’re working.

Shared Tools

Both the Game Master and Orbit can use these.

You can turn the Game Master’s roll, question, name generator, and research tools on or off in Game Master settings. Orbit uses its own tools and isn’t controlled by those switches.

New projects and games start with the Game Master’s roll, name generator, and research tools on. The Game Master’s question tool starts off, and you can turn it on when you want the GM to pause play for multiple-choice questions.

read

Looks at what’s saved in your project: open a single item, peek at a folder’s contents, or pull in several things at once so the agent doesn’t have to ask one by one.

This is how they find your files, settings, and the rest of your game’s material.

write

Creates something new or replaces what’s already there — new files, edits to existing ones, or changes to settings.

When they add a file and your project has automatic cover images turned on, a cover image is created for that file.

update

Changes only part of an entry instead of redoing the whole file. Think of tweaking one line on a character sheet or the title on a file while leaving everything else alone.

They use this when a small fix is enough, instead of a full rewrite ( write).

bash

A general-purpose way to search, organize, and manage your files — for example:

Search for text across files
Move files between folders
Delete or copy files
Create new file types (kinds of content your game uses)

map

Draws and edits maps on your location files — adding regions, pins, and tokens, or linking shapes to other locations. This is the tool behind requests like “sketch the kingdom’s borders on the world map.” See Map Tools and Location Systems for how maps work.

askUserQuestion

Puts a multiple-choice question (or a few) in front of you and waits until you answer, so the agent can proceed with your choice. You can pick from short labeled options or type your own answer when that’s clearer.

Orbit can use this tool by default. The Game Master can use it only when the question tool is turned on in Game Master settings.

generateImage

Creates an image from a prompt, following your project’s style instructions. Both agents have this tool only while image generation is turned on for the chat.

Game Master Only

generateNames

Comes up with character and place names with a sense of style and rhythm. The Game Master can lean on presets (fantasy, sci-fi, horror, noir) or blend flavors (Norse, Japanese, Arabic, and more). Available when the name generator is turned on in Game Master settings.

generateFileImage

Makes or remakes a cover image for a file. During normal file creation, covers are usually added automatically; this is for when you’ve specifically asked for an image.

askPlayerToRoll

When the roll tool is on, this is how the Game Master asks you to roll dice — your checks, saves, attacks, dice pools, and challenge-dice rolls. It shows a roller with why the roll matters, the dice, and sometimes a skill name. Play waits until you roll. Under the hood the call looks like this:

askPlayerToRoll({
  reason: "Check if you notice the hidden door",
  diceExpression: "1d20+3[WIS]",
  skillName: "Perception",      // optional, shown on the roller
  targetCharacterSlug: "mira",  // optional, which character is rolling
})

The diceExpression is where your game’s dice mechanics live. It accepts standard dice notation plus a few extras:

2d6+3 — dice with flat modifiers
4d6kh3, 2d20kl1 — keep the highest or lowest N dice
6d6[Pool] — label a dice group so it can be read on its own
1d6[Action]+2d10[Challenge]+3[Wits] — several labeled groups and modifiers in one roll
4dF+2 — Fate/Fudge dice (each die lands -1, 0, or +1)
1d20-1d6 — subtract one group from another

The roll comes back as raw dice data — each die face, which dice were kept, labeled modifiers, per-group subtotals, and a sum total. The Game Master interprets the faces by your game’s rules (counting successes in a pool, comparing action dice to challenge dice), then calls the outcome. The total is just a convenience sum; pool and challenge-dice systems ignore it.

Building your own system? The Game Master is instructed not to default to d20 — it rolls whatever expressions your rules call for. Spell your core roll out in your GM instructions (for example “resolve checks with 1d6[Action]+2d10[Challenge] plus a stat modifier”) and the roller will match your mechanics.

gmRollDice

The Game Master’s own dice. Where askPlayerToRoll hands you the dice and waits, gmRollDice rolls immediately and keeps the turn moving — NPC attacks and saves, damage, random encounters, loot tables. The result shows up as a roll card in the chat. It’s always available to the Game Master; the roll toggle only controls player rolls.

gmRollDice({
  reason: "Goblin attacks with shortbow",
  diceExpression: "1d20+4",
  fileName: "Goblin.monster",  // optional, shows the NPC's portrait on the card
})

It takes the same dice notation as askPlayerToRoll and returns the same breakdown of die faces, groups, and totals for the Game Master to read by your game’s rules.

research

Sends a short-lived helper to answer focused questions — like “what’s this character’s AC?” or “did the party already meet this NPC?” — while the main reply keeps its place. The helper searches your project’s files and the game’s message history and reports back just the facts, so the Game Master doesn’t fill its memory with whole files.

That helper only reads; it can’t edit or delete anything. A run generally costs around 0.5–1 credit but usually saves energy overall. See The Research Tool for the full story.

Orbit (Assistant) Only

revert

Rolls a file back to an earlier version from its history. Useful when an edit went wrong — ask Orbit to undo it rather than reconstructing the old content by hand. See Version History and Retention for how versions work.

subagent

Spawns parallel helper agents for wide, repetitive jobs — updating dozens of files at once instead of one at a time. See Assistant Subagents for the full story.

Inside a game, Orbit also sees the recent chat: the latest game messages are available to its read tool, so it can answer questions about what just happened. For digging deeper into a long transcript, the Game Master’s research helper is the tool that searches full game history.

PreviousMoving a World from Friends & Fables to Craft NextThe Research Tool