Khaos Machine — Windows Quick Start
=====================================

1. INSTALLATION

   Extract this zip to a folder of your choice, for example:

     C:\khaos\

   Add the folder to your PATH so the tools are available from any terminal:

     Settings > System > About > Advanced system settings
       > Environment Variables > Path > Edit > New
       > C:\khaos\

   Or from PowerShell (current user):

     [Environment]::SetEnvironmentVariable("Path",
       "$env:Path;C:\khaos", "User")

2. COPY PROMPTS

   Copy the included prompts/ folder to your Khaos data directory:

     mkdir %USERPROFILE%\.khaos\prompts
     xcopy /E /Y prompts %USERPROFILE%\.khaos\prompts\

   The analysis tools look for prompt templates in this location.

3. LAUNCH THE TERMINAL UI

   Open a terminal (Command Prompt, PowerShell, or Windows Terminal):

     khaos-tui.exe

   Press 'c' to import a screenplay project, 'g' to configure your
   AI provider, or '?' for keybinding help.

4. CHOOSE AN AI PROVIDER

   Press 'g' inside the TUI to open the configuration screen.

   Supported providers:
     - Ollama (local, free — https://ollama.com)
     - LM Studio (local, free — https://lmstudio.ai)
     - OpenAI, Anthropic, Mistral, Groq (cloud, API key required)

5. LAUNCH THE SYSTEM TRAY APP (recommended)

   Double-click khaos-machine.exe to launch the Khaos Machine
   system tray app. A K icon appears in the notification area
   (bottom-right of the taskbar).

   Right-click the K icon to:
     - Start or stop the daemon
     - Open Projects, Dashboard, Console, or Settings in your browser
     - View daemon connection status

   The tray app automatically detects the khaosd daemon and
   connects to it. No configuration needed.

6. START THE DAEMON MANUALLY (alternative)

   If you prefer to manage the daemon from the command line:

     khaosd-ctl start

   Then open http://localhost:42110 in your browser.

   To stop: khaosd-ctl stop
   To check: khaosd-ctl status

   Note: On Windows, khaosd does not auto-start on login.
   You can create a Scheduled Task if you want it to start
   automatically. See the documentation for details.

7. DATA LOCATIONS

   Config:    %USERPROFILE%\.khaos\config.json
   API keys:  %USERPROFILE%\.khaos\keys.json
   Logs:      %USERPROFILE%\.khaos\logs\
   Prompts:   %USERPROFILE%\.khaos\prompts\

For more information, visit: https://preview.khaosmachine.com
