Skip to content

gently-whitesnow/throne

BranchesTags

Repository files navigation

Throne

Приложение агентной инженерии вокруг намерения (Intent). Web UI + embedded agent terminal + static operational skills.

Миссия

Throne — приложение для агентной инженерии: дисциплины, в которой человек задаёт направление и верифицирует, а агенты выполняют.

Единица работы — Intent. Всё остальное Throne стягивает вокруг: контекст (репозитории, внешние трекеры, промпты, скиллы, память о предпочтениях), запуск агента в нужном режиме, возврат результата на верификацию и обучение на диалоге.

Свой таск-трекер — источник правды об Intent. Внешние трекеры (Jira, GitHub Issues, …) — источники контекста: Throne не строится поверх чужого трекера.

Ядро стабильное, поведение расширяемо. Сегодня зашиты режимы «работа»/«интервью» и жёсткая связка со скиллами — это временный shortcut; вектор — стабильный контракт, поверх которого пользователь описывает свои режимы, скиллы и источники контекста без страха, что расширение сломается на следующем апдейте.

Контекст

  • Кто пользователь: человек, который сочетает свои сильные стороны (вкус, воля, семантическое понимание, persistent memory) с сильными сторонами AI (пропускная способность, неутомимость, механическая согласованность).
  • Аудитория: инфраструктура для класса ai-разработчиков, не персональный инструмент одного автора.
  • Первичный артефакт: предпочтения человека. Решения и командные артефакты — в будущем.
  • Намерения (Intent): единица намерения, куда приносится работа — руками или автоматически из jira, мессенджеров, багтрекеров. Вокруг неё Throne сводит постановку, запуск агента, репозитории и ревью результата.
  • Граница: Throne оркестрирует инструменты и агентов вокруг намерения, но не подменяет их собой: код пишут агенты в своих средах, правит человек в своём IDE. Throne — это управляющий контур (постановка → агент → PR → ревью → доработка), а не ещё один редактор или агент.
  • Цикл улучшения: агент по запросу разбирает локальные диалоги → присылает патчи в Throne → человек применяет их → следующий результат ближе к ожиданиям, чем предыдущий.
  • Цель: усилить человека. Оцифровка опыта — побочный эффект того, что система помнит предпочтения и решения.

Запуск

Throne — это один self-contained бинарь throne: Kestrel в одном процессе отдаёт UI (SPA), API и SQLite. Никаких Docker/Mongo/Node/.NET SDK в рантайме. Throne работает локально, без облака и без сетевой авторизации. Основной путь — embedded-терминал в UI: Throne сам запускает агента, передаёт ему контекст, прикладывает operational skills и ведёт lifecycle через hooks. Внешний MCP endpoint удалён; dogfooding вне UI делается теми же статическими skills из репозитория через skills/<id>/bin/throne-* CLI (см. ADR-0043). Упаковка — ADR-0048.

1. Получить бинарь

Одной командой (macOS / Linux x64). Скачивает latest-релиз, ставит бинарь в ~/.throne/app, шим throne в ~/.local/bin, дописывает PATH и стартует демон с UI:

curl -fsSL https://throne.whitesnow.tech/install | bash

Идемпотентно — повторный запуск = чистая переустановка. Источник — install.sh в репо. Не поддерживается этим путём (ставь вручную, см. ниже): linux-arm64 и Windows.

Готовый. Скачай throne под свою платформу из GitHub Releases (ассеты throne-<rid>.tar.gz, для Windows — throne-win-x64.zip; RID: osx-arm64, osx-x64, linux-x64, win-x64), распакуй — внутри лежат бинарь и рядом wwwroot/skills/specs.

Собрать самому. Нужен .NET 10 SDK и pnpm только на сборку, не на запуск:

git clone https://github.com/gently-whitesnow/throne
cd throne
pnpm -C apps/web build   # UI попадает в wwwroot рядом с бинарём
dotnet publish apps/api/src/Throne.Api/Throne.Api.csproj -c Release -r <rid>

<rid> — один из osx-arm64 / osx-x64 / linux-x64 / win-x64. На выходе — single-file бинарь throne рядом с wwwroot/skills/specs.

2. Запустить

./throne                 # старт detached (демон) + открыть браузер + напечатать URL
./throne -a, --attach    # старт в foreground, логи в консоль, Ctrl-C = стоп
./throne stop            # остановить демон
./throne restart         # stop + старт detached
./throne status          # запущен ли, порт, pid, версия, путь к home
./throne logs [-f]       # хвост логов демона
./throne --help          # полная справка

Открой http://localhost:5008 (URL печатается при старте). Человеческие алиасы поверх ASP.NET-конфига:

./throne -p 9000                 # порт (поверх Urls/--urls/ASPNETCORE_URLS)
./throne --db /data/throne.db    # путь к базе (поверх Persistence:Sqlite:DataSource)
./throne --home /srv/throne      # релокация всего state-каталога; env THRONE_HOME
./throne --no-browser            # не открывать браузер (env THRONE_NO_BROWSER)

Модель инстансов. Один инстанс на state-каталог (home). Дефолтный home — ~/.throne; под ним лежат throne.db, throne.pid, throne.daemon.json, throne.log, workspaces/. Изоляция — релокацией home целиком (--home/THRONE_HOME), как GH_CONFIG_DIR/DOCKER_CONFIG. stop/restart/status/logs работают с инстансом текущего home. Демон — unix-first; на Windows работает foreground (-a), полноценный detach — позже. Деталь — ADR-0049. Raw-вход хоста — ./throne serve (как раньше; используется демоном внутри).

Дефолты подобраны так, что ничего больше настраивать не нужно: ядро single-operator local-first без сетевого auth-гейта, SQLite — ~/.throne/throne.db, workspace — ~/.throne/workspaces.

Для разработки — scripts/run-dev.sh (macOS; platform→RID диспетч заложен под другие платформы): собирает UI и поднимает хост-процесс одной командой.

./scripts/run-dev.sh              # pnpm build + dotnet run serve
./scripts/run-dev.sh --no-web     # только бэкенд, переиспользует существующий wwwroot
./scripts/run-dev.sh --publish    # собрать и запустить реальный single-file бинарь

3. Самообновление

throne update              # latest из GitHub Releases → atomic swap install-каталога
throne update --force      # обновиться даже если версия совпала
throne update --restart    # после подмены перезапустить демон на новом бинаре

4. Static operational skills для dogfooding

Operational layer лежит в репозитории обычными файлами:

  • skills/intent/SKILL.md + skills/intent/bin/throne-intent
  • skills/review/SKILL.md + skills/review/bin/throne-review
  • skills/dream/SKILL.md + skills/dream/bin/throne-dream

Embedded Run сам прикладывает нужные skills и инжектит THRONE_INTENT_ID, THRONE_API_BASE, а для review — THRONE_REPOSITORY_BINDING_ID. Если запускаешь обычную агент-сессию прямо в этом репозитории для dogfooding, приложи нужные skills/<id>/SKILL.md вручную и задай:

export THRONE_API_BASE=http://localhost:5008
export THRONE_INTENT_ID=<intent-id>

Для review можно передать binding явно:

export THRONE_REPOSITORY_BINDING_ID=<binding-id>

Агент поднимает свой инстанс. Всё в одном процессе, поэтому агент в сессии может поднять изолированный throne и продебажить сделанное, не трогая рабочий инстанс пользователя — сменой home + порта:

THRONE_HOME=$PWD/.throne-agent ./throne -p 5009   # своя база/pid/workspaces; браузер не откроется (non-TTY)
export THRONE_API_BASE=http://localhost:5009
# … подебажить через curl / UI …
THRONE_HOME=$PWD/.throne-agent ./throne stop       # остановить свой инстанс

Host-фичи: репозитории, агент-терминал, VS Code

throne — обычный хостовый процесс: он наследует твой PATH, спавнит code/claude/gh/git/tmux напрямую, ходит в OS keychain через сами CLI (без plaintext-выгрузки токенов) и использует реальный ssh-agent. Поэтому host-фичи включаются автоматически по live capability-probe: фича загорается, как только соответствующий CLI оказывается в PATH. Отдельного «host-backend режима» и тоглов в /settings больше нет — страница показывает только «Готовность» (что детектится / что доустановить).

  • Репозитории и PR-комменты. Поставь GitHub CLI (brew install gh / install_linux.md) и gh auth login как обычно — Keychain/secret-store подходит, Throne ходит в gh сам. SSH-ключи работают через твой ssh-agent (запароленные тоже). Клоны ложатся в ~/.throne/workspaces.
  • Агент-терминал и Run. Поставь tmux (brew install tmux) и залогинь Claude Code на хосте (claude → /login). Кнопка «Запустить агента» поднимает tmux-сессию throne-{intent_id} с claude под твоим аккаунтом и стримит её в браузер; сессия живёт в tmux-демоне и переживает рестарт Throne.
  • Open in VS Code. Поставь команду code в PATH (VS Code → Command Palette → «Shell Command: Install 'code' command in PATH») — capability vscode загорится.

Если нужного CLI нет в PATH, соответствующая секция («Репозитории» / «PR comments» / «Терминал») просто не появляется, остальное работает. См. ADR-0048.

Структура

throne/
├── apps/
│   ├── api/                 # .NET 10 backend (HTTP API + embedded terminal)
│       ├── src/
│       │   ├── Throne.Domain/
│       │   ├── Throne.Application/
│       │   ├── Throne.Infrastructure/
│       │   └── Throne.Api/
│       └── tests/
│           ├── Throne.Domain.Tests/
│           ├── Throne.Application.Tests/
│           ├── Throne.Infrastructure.Tests/
│           ├── Throne.Api.Tests/
│           └── Throne.Architecture.Tests/
│   ├── web/                 # Vite + React + TypeScript frontend
│   │   └── src/             # FSD 2.0: app/pages/widgets/features/entities/shared
│   └── landing/             # Next.js public landing (static export → VPS)
├── specs/
│   ├── ADR/                 # Architecture Decision Records
│   └── AGENTS.local.md
├── skills/                  # static provider-neutral operational skills
├── bin/                     # throne-intent/review/dream CLI scripts
├── scripts/quality/         # verify.sh + sub-scripts
├── .quality/                # quality.config.json
├── ROOT.md                  # общие правила для агентов (канон)
├── AGENTS.md                # Codex/agent entrypoint (стаб → ROOT.md)
├── CLAUDE.md                # Claude entrypoint (стаб → ROOT.md)
└── DESIGN.md                # frontend design system

Архитектура

Clean Architecture в apps/api. Зависимости — внутрь:

Api → Application → Domain
Infrastructure → Application → Domain
Api → Infrastructure (только в DI)

Защита направлений — Throne.Architecture.Tests на NetArchTest.

См. ADR-0001.

Frontend в apps/web строится по FSD 2.0. Структуру и imports защищает Steiger.

См. ADR-0005.

Quality gates

bash scripts/quality/verify.sh                     # backend + frontend
bash scripts/quality/verify.sh --fast              # без security audit
bash scripts/quality/verify.sh --scope backend     # только backend
bash scripts/quality/verify.sh --scope frontend    # только frontend
bash scripts/quality/verify-backend.sh             # backend-only
bash scripts/quality/verify-frontend.sh            # frontend-only

Запускается перед каждым коммитом и завершением хода агента.

Технологии

  • .NET 10
  • SQLite через EF Core (~/.throne/throne.db по умолчанию)
  • GitHub CLI gh + git (опционально — для секций «Репозитории» и «PR comments»; включаются автоматически, когда gh/git есть в PATH)
  • Vite + React + TypeScript
  • FSD 2.0 + Steiger
  • xUnit + FluentAssertions
  • Central Package Management (Directory.Packages.props)

Где что искать

Документ Что
specs/ADR/REGISTRY.md Реестр архитектурных решений
specs/AGENTS.local.md Правила для AI-агентов в этом проекте
specs/contracts/AGENTS.md HTTP API контракты (OpenAPI source of truth)
specs/contracts/realtime/events.yaml Realtime server→client события (yaml source of truth) + ADR-0008
specs/manifest/throne-system-prompt-parts.yaml System instructions + embedded-композиция по режимам (источник правды)
skills/intent/SKILL.md / skills/review/SKILL.md / skills/dream/SKILL.md Static operational skills
specs/ADR/0043-static-operational-skills-and-mcp-removal.md Operational skills as repo files + MCP removal
DESIGN.md Дизайн-система фронтенда
ROOT.md Общие правила для агентов (канон)
AGENTS.md Точка входа для Codex/агентов (стаб → ROOT.md)
CLAUDE.md Точка входа для Claude (стаб → ROOT.md)
CONTRIBUTING.md Как контрибьютить: разделы PR, коммиты, лимит бизнес-логики
CODE_OF_CONDUCT.md Кодекс поведения (Contributor Covenant 2.1)

About

Throne — приложение агентной инженерии вокруг намерения.

throne.whitesnow.tech/

Resources

Readme

License

MIT license

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 8

Throne v1.1.0 Latest
Jul 16, 2026
+ 7 releases

Packages

 
 
 

Contributors

Languages