Storytelling intelligence for independent screenwriters

Order from chaos.

Read the structure, pacing, rhythm, and character balance of your screenplay with tools built for long working sessions, dense analysis, and craft-first review.

macOS (Apple Silicon) · Linux (amd64 / arm64) · Windows (amd64) · No account required

foundation v0.0.286 gui v0.3.2 khaosd v0.3.203
Dashboard workspace scene breakdown · dramatic beats · character balance
Khaos Machine dashboard showing screenplay analysis, scene breakdown, character detail, and dramatic beats

Core workflow

A work surface, not a demo funnel

The platform is organized like the product itself: import, inspect, route analysis, and review output in dense but calm surfaces.

1

Import the screenplay

Create a project, ingest the script, and let the parser extract scenes, characters, and locations into the KSPD structure the rest of the system understands.

.fountain .fdx .sbx .pdf .txt
2

Route analysis intelligently

Stay entirely local with Ollama or LM Studio, or connect OpenAI, Anthropic, Gemini, Groq, and other providers depending on the kind of analysis you need.

Ollama LM Studio OpenAI Anthropic Gemini Groq
3

Review structure, not just prose

Read dramatic beats, character presence, dialogue balance, pacing, and location significance across dashboard, story player, coverage, and character-builder views.

Workspace pattern

List + inspector as the default review model

Most screens pair a dense list or navigation surface with a focused inspector. That keeps the screenplay primary while analysis, metadata, and tooling stay close at hand.

Primary views
Projects, dashboard, console, story player, coverage
Shared ui
`khaos-ui` components and page shells now align the apps under one design language
Long-session fit
Warm neutrals, restrained feedback states, and dense information without chrome noise
Projects workspace imported screenplays · project counts · provider-aware workflows
Khaos Machine project browser showing screenplay projects, scene counts, and analysis status

Analysis model

The system reads story structure through multiple lenses

The goal is not a generic summary. It is to expose how the screenplay is functioning scene by scene, character by character, and location by location.

Scene layer

Pacing, mood, dramatic beats, and thematic function

Each scene can be evaluated as part of the larger rhythm of the screenplay, not as an isolated paragraph of text.

Character layer

Presence, dialogue distribution, goals, conflict, and arc

Qualitative reading and quantitative balance live together so you can see both the intuition and the evidence.

Location layer

Atmosphere, symbolism, recurrence, and story utility

Locations are treated as narrative assets, not only production references.

Why this system exists

Built to disappear behind the screenplay

The interface is quiet on purpose. The work is understanding story shape, not managing a noisy stack of tools.

Local-first

Your screenplay stays on your machine

Run fully local workflows when privacy or cost matters, and add cloud analysis only where it earns its place.

Provider routing

One project, multiple model perspectives

Store and compare output per provider instead of flattening every analysis run into one opaque result.

Desktop-native workflow

Signed installers, daemon-backed tools, and embedded workspaces

Install once and get the dashboard, CLI tooling, background services, and desktop entry points together.

Incremental analysis

Let the system keep up while you write

Optional background workflows and scope-aware analysis keep results current without rerunning everything from scratch.

Install

Get the whole stack in one package

The installer brings down the GUI workspaces, CLI tools, prompt assets, and daemon helpers with one release.

# Auto-detect platform, download the latest release, and install:
curl -fsSL https://preview.khaosmachine.com/install.sh | bash
# Download the signed package, then open it:
open KhaosFoundation-signed.pkg

# Or install directly from Terminal:
sudo installer -pkg KhaosFoundation-signed.pkg -target /
# Download the .deb for your architecture, then:
sudo apt install ./khaos-foundation_0.0.286_amd64.deb

# For arm64:
sudo apt install ./khaos-foundation_0.0.286_arm64.deb
# Download the .rpm for your architecture, then:
sudo rpm -i khaos-foundation_0.0.286_amd64.rpm

# For arm64:
sudo rpm -i khaos-foundation_0.0.286_arm64.rpm
# Download the zip, extract it, and add the folder to PATH:
Expand-Archive khaos-foundation-0.0.286-windows-amd64.zip -DestinationPath C:\khaos

# Add to PATH (current user, PowerShell):
[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\khaos\khaos-foundation", "User")

# Launch the TUI:
khaos-tui.exe

Current release

v0.0.286

khaosd v0.3.203 tools v0.5.102 wfl v0.0.90 gui v0.3.2