WorkAI регистрирует в системе схему `workai://`. Если клиент уже запущен, ссылка переключает на него; если нет — система запускает приложение и передаёт ему действие.

Промпт и правило в такой ссылке — это текст. Клиент его не исполняет: промпт только подставляет в поле ввода, правило записывает только после вашего подтверждения. Ссылки на плагин — другое: после согласия клиент ставит код с указанного источника.

Мессенджеры и почта часто не открывают `workai://` напрямую. Для промпта и правила есть страница на сайте: она сама попытается открыть клиент, а если не выйдет — покажет кнопки «Открыть в WorkAI» и «Скачать клиент».

```
https://workai.su/link/prompt?text=<текст промпта>
https://workai.su/link/rule?name=<имя-файла>&text=<текст правила>
```

Параметры те же, что у `workai://share/…` ниже. Неизвестный тип (`/link/что-то-ещё`) не открывает приложение: страница напишет, что ссылка недействительна.

## Поделиться промптом

```
workai://share/prompt?text=<текст промпта>
```

Открывает чат и подставляет текст в поле ввода. На этом всё: отправка модели — отдельное ваше действие, кнопкой или Enter. Клиент никогда не отправляет промпт из ссылки сам.

Если в поле ввода уже есть черновик или прикреплённые файлы, ссылка их не затрёт — промпт откроется в новом чате.

Если ссылка попала в окно, где панели чата нет (пустое окно, окно агентов без чата), текст никуда не подставится и ошибки на экране не будет. Откройте обычное окно редактора и перейдите по ссылке ещё раз.

Текст нужно закодировать для URL (percent-encoding): `&` превращается в `%26`, `+` — в `%2B`, пробел — в `%20`. Пример:

```
workai://share/prompt?text=%D0%9E%D0%B1%D1%8A%D1%8F%D1%81%D0%BD%D0%B8%20%D1%8D%D1%82%D0%BE%D1%82%20%D1%84%D0%B0%D0%B9%D0%BB
```

## Поделиться правилом

```
workai://share/rule?name=<имя-файла>&text=<текст правила>
```

Предлагает сохранить правило для агента в файл `.workai/rules/<имя-файла>.md` в открытом проекте. Перед записью клиент показывает диалог подтверждения с полным текстом правила — целиком, без сокращений, потому что именно этот текст затем будет подмешиваться в запросы к модели. Ничего не создаётся, пока вы не нажмёте «Сохранить правило».

Требования:

- **Должна быть открыта папка или воркспейс.** Иначе сохранять некуда — клиент покажет ошибку и предложит сначала открыть проект. Правило записывается в первую папку воркспейса.
- **`name`** — только строчные латинские буквы, цифры и дефис, от 1 до 64 символов, без слешей и точек, первый и последний символ — не дефис (`commit-lang`, `api-style`). Имя используется как имя файла.
- **Существующий файл не перезаписывается.** Если правило с таким именем уже есть, сохранение не пройдёт, и клиент об этом сообщит.

После сохранения файл открывается в редакторе. Что такое правила, где они лежат и как активируются — см. [Правила](/docs/rules).

### Ограничение по длине

И промпт, и правило передаются целиком внутри ссылки, поэтому вся ссылка `workai://share/…` не должна быть длиннее 8000 символов. Более длинная просто игнорируется — диалога об ошибке не будет. Для больших правил надёжнее приложить сам markdown-файл. На проект Создателя и плагины этот лимит не распространяется.

## Открыть проект Создателя в клиенте

```
workai://open-builder-web-project?projectId=…&handoffToken=…&apiOrigin=…
```

Эту ссылку не составляют руками — её формирует пункт «Открыть в IDE» в меню проекта в веб-интерфейсе Создателя. Клиент проверяет параметры, спрашивает подтверждение и затем скачивает проект и открывает его как папку в новом окне.

Адрес сервера в ссылке сверяется со списком доверенных доменов WorkAI: подменить его на чужой в скопированной ссылке не получится — такая ссылка будет отклонена до всякого диалога. Про сам режим — [Создатель](/docs/builder/overview).

## Установить плагин или добавить маркетплейс

```
workai://chat-plugin/install?source=<owner/repo>
workai://chat-plugin/add-marketplace?ref=<owner/repo>
```

Эти ссылки обычно присылает маркетплейс, а не составляют вручную как промпт. Первая предлагает установить плагин из указанного источника, вторая — добавить маркетплейс плагинов в каталог. `source` и `ref` принимаются и как обычный `owner/repo` или git-URL, и в base64. У первой ссылки можно дополнительно указать `plugin=<имя>` — тогда после установки откроется карточка именно этого плагина.

Оба маршрута всегда показывают диалог подтверждения с указанием источника: плагины выполняют код на вашей машине, поэтому устанавливайте их только из источников, которым доверяете.

## Что происходит с ссылками, которые вы не открывали сами

Часть ссылок `workai://` клиент и браузер используют между собой служебно — например, чтобы вернуть фокус в приложение после входа в аккаунт. Их не нужно составлять или хранить: они одноразовые и появляются только в момент, когда вы сами инициировали действие.

## Безопасность

Ссылку `workai://` может прислать кто угодно, поэтому каждое действие устроено так, чтобы одного перехода по ссылке было недостаточно:

- промпт только подставляется в поле ввода — отправляете его вы;
- правило записывается только после подтверждения, и в диалоге показан весь его текст;
- проект Создателя и плагин требуют явного подтверждения, и в диалоге показан источник; у проекта Создателя адрес сервера дополнительно сверяется со списком доверенных доменов;
- некорректные параметры (пустое имя, слишком длинный `share`-URL, чужой адрес сервера) клиент отбрасывает до диалога — на экране ничего не появится. Исключение: правило без открытой папки — тогда будет ошибка с просьбой открыть проект;
- промпт в окне без панели чата тоже проходит тихо: ссылка считается обработанной, поле ввода не меняется.

Общий принцип тот же, что и в [режимах запуска агента](/docs/agent/security/run-modes): необратимое действие всегда требует вашего явного согласия. Тем не менее относитесь к присланной ссылке как к присланному файлу — читайте текст в диалоге подтверждения, прежде чем соглашаться.