Skip to content

Latest commit

 

History

92 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

English · 繁體中文 · 简体中文

Spindle

Spindle

A local-first Yarn Spinner dialogue editor for writers and game developers. Write in source or a reading editor, arrange branches on a flowchart, and connect a local agent through MCP.

Download Windows x64 · Release notes · Report an issue

Portable and installer builds are unsigned. Review the verification report before installing.

Three views of one story

Source

Write Yarn directly with completion, diagnostics and quick fixes. Completion includes built-in and project commands with parameter hints; hovering a registered custom command shows its description and signature.

Source command completion

Custom command help

Reading editor

Edit dialogue in a more readable layout, or switch to dialogue-only reading without changing the Yarn source.

Reading editor

Flowchart

Arrange scenes when you choose, then move cards and pins to preserve your own layout.

Flowchart

Search, history and appearance

Search scripts, content, settings and commands from one palette. Projects support quiet autosave, document history, multiple windows and a recoverable trash. Shared appearance defaults can be overridden for each editor mode.

Unified search Editor appearance
Unified search Editor appearance

Compare saved revisions before restoring them.

Version comparison

Start writing

  1. Open a project folder or create one from the launcher.
  2. Press Ctrl+P, choose New script, name it and write Yarn.
  3. Switch among Source, Reading editor and Flowchart; Ctrl+Shift+F searches across the project and settings.

Projects keep configuration, history and trash in .spindle/. An existing .yarn file can also open on its own. A new workspace starts empty.

To explore branches, copy The Last Light demo project to a personal folder and open that folder in Spindle. Its three scripts and custom command definitions are not bundled as your default project.

MCP and Skill

Enable read-only or editing access in Settings → MCP / Agent integration, then install a user-level Codex or Claude Code connection and the Spindle Skill. Keep Spindle running. An agent can inspect selections, validate scripts, manage commands and make version-protected edits; Skill installation does not change agent approvals.

Agent integration

Connection and installation guide

Development and license

Use Node.js 22.22.0 and the pnpm version pinned in package.json.

pnpm install --frozen-lockfile
pnpm dev                 # Web
pnpm desktop:start       # Windows desktop
pnpm test:unit
pnpm lint
pnpm desktop:pack        # Windows Portable + NSIS

version.json is the product-version source. Spindle is licensed under GPL-3.0-only; third-party components keep their own licenses in third-party notices. See contributing and security reporting.

Architecture · UI conventions · Release process · Changelog

About

Spindle is a visual Yarn script editor for branching stories.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages