Storytelling intelligence for independent screenwriters

Order from chaos.

Read the structure, pacing, rhythm, and character balance of your screenplay in a native desktop app built for long working sessions, dense analysis, and craft-first review.

Khaos App — macOS, Linux amd64, Windows amd64 · Linux arm64 — CLI + engine · No account required

foundation v0.5.286 khaosd v0.132.0

Core workflow

A work surface, not a demo funnel

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

1

Import the screenplay

Open or drag in a script and let the parser extract scenes, characters, and locations into the KSPD document the rest of the system understands — a real Mac document with Quick Look and Versions.

.fountain .fdx .sbx .pdf .txt
2

Route analysis intelligently

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

On-device Ollama LM Studio OpenAI Anthropic Gemini
3

Review structure, then press play

Read dramatic beats, character presence, dialogue balance, pacing, and location significance across the Project, Insights, and Character Builder views — then hear a story-aware performance in the Story Player.

Workspace pattern

Sidebar + detail as the default review model

The app pairs a dense navigation sidebar with a focused detail view. That keeps the screenplay primary while analysis, metadata, and tooling stay close at hand — the way a native document app should feel.

Primary views
Project, Story Player, Insights, Character Builder, Events
Built with
Native SwiftUI; KSPD opens as a document; the local `khaosd` engine runs underneath
Long-session fit
Warm neutrals, restrained feedback states, and dense information without chrome noise

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 — and hear any character's lines on-device.

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 on-device or local workflows when privacy or cost matters, and add cloud analysis only where it earns its place.

Press play

Hear a story-aware performance

The Story Player turns the composition into on-device narration with per-character voices — review rhythm and dialogue with your ears, not just your eyes.

Desktop-native

A signed, notarized Mac app over a local engine

One signed package installs Khaos App, the background daemon, and the CLI tools 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

Khaos App ships with the engine and tools on macOS, Linux amd64, and Windows amd64. Linux arm64 remains daemon/CLI-only.

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

# Or install directly from Terminal:
sudo installer -pkg KhaosFoundation-signed.pkg -target /

# Khaos App installs to /Applications alongside the local daemon and CLI tools.
# Engine only: daemon and CLI. Khaos App is macOS-only for now.
# Download the .deb for your architecture, then:
sudo apt install ./khaos-foundation_0.5.286_amd64.deb

# For arm64:
sudo apt install ./khaos-foundation_0.5.286_arm64.deb
# Engine only: daemon and CLI. Khaos App is macOS-only for now.
# Download the .rpm for your architecture, then:
sudo rpm -i khaos-foundation_0.5.286_amd64.rpm

# For arm64:
sudo rpm -i khaos-foundation_0.5.286_arm64.rpm
# Engine only: daemon and CLI. Khaos App is macOS-only for now.
# Extract the zip, then:
cd khaos-foundation
.\\khaosd-ctl start
.\\khaos-tui.exe

Current release

v0.5.286

khaosd v0.132.0 tools v0.84.0 Khaos App v0.60.0