World CLI for Foundry VTT

Tell your AI agent what should change in your Foundry VTT world, and it happens in the live world, validated by Foundry, visible to your players immediately.

Give the terminal AI agent you already use, such as Claude Code or Codex, safe, live access to your Foundry world. Through your open GM session, it can:

• Build and edit characters and their inventories, or import them from compendiums.
• Write journals and organize them into folders.
• Set up scenes and edit individual tokens, walls, and lights.

Every change runs through Foundry's own Document APIs, exactly as if you had made it in the UI. The agent can work without browser automation or editing world files on disk.

This module contains no AI and calls none. You bring your own agent, and you decide what it may do.

Requires the separate fvtt-world-cli npm package and Node.js 20+. The package includes the CLI your agent runs and a local daemon that connects it to this module. You can point your agent at the GitHub repository and ask it to set up World CLI for Foundry VTT.

For manual setup, start by installing the CLI:

npm install -g fvtt-world-cli

Then follow Getting started to start the daemon, pair your GM browser, and check the connection.

Supported on Foundry VTT v13 and v14, both verified. The package also ships an installable Agent Skill that teaches an agent to drive the CLI safely.

GitHub · Getting started · Documentation