# KingKont - редактор AI-видео

Локальный нод-редактор сцен с AI-генерацией (картинки, видео, голос, SFX,
музыка, текст). Каждая «сцена» — папка на диске с `scene.json`, файлы
лежат рядом, любой инструмент может читать их без редактора.

## Быстрый старт

```bash
npx kingkont
```

Откроется Electron-приложение. На welcome-экране — большая кнопка
«Открыть проект»: выберешь любую папку, она и станет проектом.

## Через браузер вместо Electron

```bash
npx kingkont serve
```

Поднимет HTTP-сервер на `http://localhost:17893` — открой в Chrome /
Edge / Brave (нужен File System Access API). Удобно для встраивания в
preview-окна, удалённых машин и т.п.

## Что внутри проектной папки

```
my-project/
├── CLAUDE.md             ← авто-создаётся при первом открытии,
│                            описывает структуру для AI-агентов
├── _characters/
├── _locations/
├── <сцена>/
│   ├── scene.json
│   ├── clips/  images/  audio/  texts/
└── _deleted/             ← корзина, Cmd+Z восстанавливает
```

## Ключи API

При первой попытке генерации редактор попросит API-ключи через `Cmd+,`:

- **KIE** (`api.kie.ai`) — для картинок и видео
- **ElevenLabs** (`elevenlabs.io`) — голос, SFX, музыка
- **OpenRouter** (`openrouter.ai`) — текст и vision

Хранятся в `~/Library/Application Support/KingKont/settings.json` (на
macOS) — переустановка приложения их не теряет.

## Шорткаты

| Действие | macOS |
|---|---|
| Открыть проект | `Cmd+O` |
| Новая сцена | `Cmd+N` |
| Закрыть проект / окно | `Cmd+W` |
| Настройки | `Cmd+,` |
| Undo / Redo | `Cmd+Z` / `Cmd+Shift+Z` |
| Cut / Copy / Paste | `Cmd+X` / `Cmd+C` / `Cmd+V` |
| Esc | закрыть любую модалку |

## Скилл для Claude Code

Чтобы Claude Code в любой сессии умел запускать редактор для текущей папки:

```bash
npx kingkont install-skill            # для всех проектов: ~/.claude/skills/kingkont/
npx kingkont install-skill --project  # только для текущего проекта: ./.claude/skills/kingkont/
```

После этого в новой сессии Claude Code достаточно сказать «открой kingkont»
или «запусти редактор» — Claude увидит скилл, выполнит `npx -y kingkont serve`
в текущей папке и подскажет URL для Chrome.

## Разработка

```bash
git clone <repo>
cd kingkont
npm install
npm start              # обычный dev-запуск Electron
npm run dist           # собрать .dmg (mac) / .exe (win) / .AppImage (linux)
```
# kingkont
