Verse Extended

Verse Extended is a standalone VS Code extension for Verse authoring.

It provides:

• custom Verse TextMate grammar rules
• two bundled themes:
  • Verse Extended (Dark)
  • Verse Extended (Visual Assist Dark)
• an MCP-friendly Verse build command that supports agentic Verse development workflows

Verse Extended works with two external VS Code extensions:

• epicgames.verse User-installed prerequisite that provides the default Verse build command verseWorkflow.compile.
• juehangqin.vscode-mcp-server Declared dependency that provides the MCP bridge used by AI agents to execute VS Code commands remotely.

• Handles Verse declaration patterns that the stock grammar misses more often, including specifier-heavy declarations, extension functions, operator declarations, parametric type declarations, optional type annotations, and inheritance lists.

• Verse Extended (Dark) is the main theme.
• Verse Extended (Visual Assist Dark) follows a Visual Assist-inspired palette using the same token mapping.

• Provides an agent-friendly Verse build command that works cleanly through a VS Code MCP bridge.
• The command can capture a timestamped log snapshot for workflows that want a saved artifact, but that is a secondary convenience, not the point of the feature.
• The default build command is verseWorkflow.compile, provided by the Epic Verse extension.
• AI agents can invoke VerseExtended: Build and Dump Log through a VS Code MCP server bridge.

• VerseExtended: Build and Dump Log

• verseextended.logPath Path to the Verse build log file, relative to the workspace root.
• verseextended.dumpDir Directory where log snapshots are written, relative to the workspace root.
• verseextended.pollIntervalMs Poll interval while waiting for the build log to update.
• verseextended.maxWaitMs Maximum wait time before the command gives up.
• verseextended.command VS Code command ID used to trigger the build. Defaults to verseWorkflow.compile.

Install Epic's official Verse extension first. Verse Extended uses Epic's Verse build command by default.

1. Clone or download this repository.
2. Open the repository root in VS Code.
3. Press F5 to launch an Extension Development Host.

1. Run cmd /c package_extension.cmd from the repository root.
2. Install the generated .vsix in VS Code.

cmd /c package_extension.cmd
code --install-extension verseextended-0.1.1.vsix

1. Select either Verse Extended (Dark) or Verse Extended (Visual Assist Dark) from the VS Code theme picker.
2. Open a Verse workspace.
3. Run VerseExtended: Build and Dump Log.
4. Check the workspace Logs folder for the dumped build log snapshot.

If your environment does not use the defaults, adjust:

• verseextended.logPath
• verseextended.dumpDir
• verseextended.command

• Shared token-to-scope mapping lives in theme_tokens.json.
• Per-theme palettes live in theme_palettes.json.
• Generated theme outputs:
  • verse-extended-dark.tmTheme.json
  • verse-extended-visual-assist-dark.tmTheme.json

Regenerate theme outputs after palette changes:

python build_themes.py

• This extension currently uses TextMate grammar rules, not semantic token providers.
• Rule order in verse-extended.json matters. More specific rules must appear before generic identifier matches.
• VerseExtended: Build and Dump Log assumes the Epic Verse command ID remains available. If you change verseextended.command, you are changing the execution contract on purpose.

• AGENTS.md provides AI agents with the Verse/MCP workflow context needed to use VerseExtended and related MCP command paths correctly.
• It is intended to be merged into a project's AGENTS.md or CLAUDE.md so agents operating inside a Verse workspace inherit the right execution and validation rules.

MIT. See the LICENSE file included with the extension package.

See the THIRD_PARTY_NOTICES.md file included with the extension package.