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.
Storytelling intelligence for independent screenwriters
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
Core workflow
The app is organized like the work itself: import, inspect, route analysis, and review output in dense but calm native surfaces.
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.
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.
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
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.
Analysis model
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
Each scene can be evaluated as part of the larger rhythm of the screenplay, not as an isolated paragraph of text.
Character layer
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
Locations are treated as narrative assets, not only production references.
Why this system exists
The interface is quiet on purpose. The work is understanding story shape, not managing a noisy stack of tools.
Local-first
Run fully on-device or local workflows when privacy or cost matters, and add cloud analysis only where it earns its place.
Press play
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
One signed package installs Khaos App, the background daemon, and the CLI tools together.
Incremental analysis
Optional background workflows and scope-aware analysis keep results current without rerunning everything from scratch.
Install
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
Direct downloads
Current release
v0.5.286