Ting / Микро-приложения
Микро-приложения: свои инструменты на клавише
Микро-приложение — небольшой YAML-файл, который Ting запускает по клавише. Он читает буфер обмена, спрашивает несколько значений, выполняет код оболочки или Python, HTTP-запросы или обращается к модели ИИ и показывает или копирует результат. Проще всего получить такой файл — попросить агента для программирования написать его.
Попросите агента (рекомендуем)
Изучать формат не обязательно. Агент, например Claude Code, Codex или pi, читает руководство по формату внутри Ting.app, пишет файл, проверяет его через ting-micro и кладёт на место. Он также может добавить привязку клавиши в ваш config.json.
- В меню Ting в строке меню выберите Copy Agent Prompt (эта кнопка есть и в Settings › Advanced). Ting скопирует готовый текст с путями вашего Mac.
- Запустите агента в терминале и вставьте текст.
- После последней строки «My task:» напишите задачу обычными словами: какая клавиша, что подаётся на вход, что должно произойти и куда деть результат.
- Дождитесь, пока агент закончит. Он пишет файл во временной папке, проверяет его, пока
ting-micro checkне ответитok, переносит в~/.config/ting/micro/и проверяетconfig.jsonкомандойting-micro check-config. - Нажмите клавишу. Ting один раз покажет весь файл: Command-Return одобряет, Esc отказывает.
Запрос может быть совсем коротким:
Write a new Ting micro-app: Leader t a should translate the
clipboard into German and copy the translation.Без Copy Agent Prompt запустите агента с этим текстом и допишите задачу:
Change my Ting setup. Read /Applications/Ting.app/Contents/Resources/CONFIGURING.md
and follow it; for micro-apps it points to FORMAT.md. Check every file with
ting-micro before you finish. Never put API keys into files and never touch
~/Library/Application Support/Ting/.
My task:Как получить хороший результат:
- Назовите последовательность клавиш, например «Leader t a». Если она уже занята, агент спросит перед заменой.
- Скажите, куда деть результат: скопировать в буфер обмена, показать в панели или и то и другое.
- Никогда не вставляйте API-ключ в чат. Храните ключи в окружении оболочки или в связке ключей (см. «Ключи и секреты») и назовите агенту их имена.
- Если нужно семейство похожих инструментов, например перевод на разные языки, попросите использовать библиотеку.
- Агент должен спросить вас, прежде чем запускать микро-приложение, которое обращается к платному API или меняет файлы.
Полные руководства, по которым работает агент: CONFIGURING.md (https://github.com/bobuk-io/ting/blob/v0.5.0/docs/CONFIGURING.md) и FORMAT.md (https://github.com/bobuk-io/ting/blob/v0.5.0/docs/micro-apps/FORMAT.md). Они на английском.
Первое микро-приложение вручную
Сохраните этот текст в ~/.config/ting/micro/sort-lines.yaml. Ting сразу загружает папку, ничего перезапускать не нужно.
format: ting.microapp/2
id: sort-lines
name: Sort lines
description: Sort the clipboard lines and drop duplicates.
input: clipboard
command: LC_ALL=en_US.UTF-8 sort -u
output:
to: [clipboard, panel]
as: text- Откройте Settings › Bindings, выберите + › Micro-app и укажите Sort lines. Или запустите его по имени из launcha.
- Скопируйте несколько строк и нажмите клавишу. В первый раз одобрите файл клавишами Command-Return.
- Отсортированные строки окажутся в буфере обмена и в панели.
Файл с ошибкой Ting не использует: меню в строке меню предупреждает, Settings › Advanced показывает ошибку с номером строки, а ~/.config/ting/micro-errors.log хранит её.
Файл
| Ключ | Значение |
|---|---|
format | Всегда ting.microapp/2. |
id, name | id пишется в kebab-case (sort-lines), по умолчанию это имя файла. name показывается в меню. |
description | Одна строка, обязательно. |
params | Значения, которые Ting спрашивает перед запуском: text или choice. Обязательные видны всегда; необязательным нужен default, они открываются по Command-O. |
input | clipboard (текст идёт на вход первому шагу) или none. |
command или steps | Одна команда оболочки или список шагов (ниже). |
output | to: [clipboard, panel] и as: markdown | console | text | code. Без output ничего не показывается и не копируется. |
timeout | Время всего запуска в секундах: по умолчанию 60, максимум 300. |
tools | Программы, которые нужны коду в PATH, например [dig, jq]. |
hidden, remember | hidden: true скрывает из launcha; remember: false не предлагает прошлые значения. |
В код оболочки и Python параметры попадают как переменные окружения: domain становится $TING_DOMAIN.
params:
- name: domain # read as ${params.domain} or $TING_DOMAIN
type: text
required: true
prompt: Domain
- name: record
type: choice
required: false
default: A
choices: [A, AAAA, MX, TXT]
input: none
command: dig +noall +answer "$TING_DOMAIN" "$TING_RECORD"Шаги
Вместо одной command микро-приложение может выполнять список steps. Вывод каждого шага идёт на вход следующему, как в конвейере оболочки; вывод последнего шага — результат. Если шаг завершился ошибкой, запуск останавливается, а панель показывает, какой шаг упал и почему.
| Шаг | Что делает |
|---|---|
command | Код для /bin/sh -c: вход через stdin, результат в stdout. |
python | Код для python3 (стандартная библиотека; нужны Xcode Command Line Tools). |
url | HTTP-запрос: method, query, headers, body (текст или JSON) или form. Вывод — тело ответа. |
ai | Сообщение для openai или anthropic или любого OpenAI-совместимого сервера через base_url (Ollama, LM Studio, OpenRouter). Ответ появляется в панели по мере поступления. |
text | Текст с переменными. |
json | Поле входного JSON, например items.0.name. |
open | Открывает URL или файл, при желании в указанном приложении (app). |
notify | Показывает уведомление. |
call | Запускает библиотеку (см. «Библиотеки»). |
У каждого шага может быть id (следующие шаги читают его вывод как ${steps.ID}), свои stdin, timeout и params. С stream: true шаг command или python читает вывод предыдущего шага по мере поступления.
Это микро-приложение ищет слово из буфера обмена в Википедии и показывает краткое описание со ссылкой:
format: ting.microapp/2
name: Wikipedia summary
description: Show the Wikipedia summary of the clipboard word or title.
input: clipboard
steps:
- url: https://en.wikipedia.org/api/rest_v1/page/summary/${input|trim|url}
id: page
- json: extract
id: extract
- json: content_urls.desktop.page
stdin: ${steps.page}
- text: |
${steps.extract}
${input}
output:
to: [panel]
as: markdownШаг ИИ и шаг Python:
steps:
- ai: ${input}
provider: anthropic
model: claude-haiku-5-5
key: ${keychain.anthropic}
system: Answer in one short paragraph.steps:
- python: |
import json, sys
data = json.load(sys.stdin)
print(json.dumps(data, indent=2, sort_keys=True, ensure_ascii=False))Переменные
Любое значение шага, кроме кода оболочки и Python, может содержать переменные:
| Переменная | Значение |
|---|---|
${input} | Вход шага. |
${params.NAME} | Параметр. |
${steps.ID} | Вывод одного из предыдущих шагов. |
${NAME} | Переменная вашей оболочки входа, например ${OPENAI_API_KEY}. |
${keychain.SERVICE} | Пароль из вашей связки ключей. |
Фильтры после |: url (кодирование для URL), json (экранирование для строки JSON), trim, base64. Например, ${input|trim|url}.
Ting никогда не подставляет текст в код оболочки и Python. Код читает те же значения из окружения: $TING_NAME для параметров, $TING_STEP_ID для вывода шагов и переменные, заданные в env:. Так текст из буфера обмена не может стать командой.
Библиотеки
Шаги, общие для нескольких микро-приложений, хранятся один раз в ~/.config/ting/micro/libs/NAME.yaml с format: ting.microlib/1. У библиотеки нет клавиши, и в launcha её нет.
# ~/.config/ting/micro/libs/translate.yaml
format: ting.microlib/1
description: Translate the input text with OpenAI.
params:
- name: language
type: text
required: false
default: English
input: clipboard
steps:
- ai: ${input}
id: translate
provider: openai
model: gpt-4.1-mini
system: Translate the text into ${params.language}. Answer with the translation only.
output:
to: [clipboard, panel]
as: textЧтобы сделать вариант, который отличается только значениями, унаследуйте библиотеку. Этот файл — та же библиотека с немецким языком, поэтому он ничего не спрашивает:
# ~/.config/ting/micro/translate-german.yaml
format: ting.microapp/2
inherit: translate
id: translate-german
name: Translate to German
description: Translate the clipboard text into German.
steps:
- id: translate
params:
language: GermanИли запустите библиотеку как один шаг через call и передайте ей параметры:
steps:
- call: translate
params:
language: ${params.language}Микро-приложение одобряется вместе с его библиотеками. После изменения библиотеки Ting снова спросит про каждое микро-приложение, которое её использует.
Ключи и секреты
Никогда не пишите API-ключ в файл микро-приложения. Ting выполняет шаги с окружением вашей оболочки входа, поэтому ключ, экспортированный в профиле оболочки, доступен как ${OPENAI_API_KEY} или ${ANTHROPIC_API_KEY}; шаг ai по умолчанию берёт именно их. Или храните ключ в связке ключей:
security add-generic-password -s anthropic -a "$USER" -wи читайте его как ${keychain.anthropic}. Не вводите секреты в параметры, которые Ting запоминает: запомненные значения хранятся обычным текстом.
Проверка и запуск в терминале
ting-micro внутри Ting.app проверяет и запускает микро-приложения без панелей. run читает вход из stdin и печатает результат; он не трогает буфер обмена, конфигурацию и одобрения. Шаги open и notify выполняются только с --allow-effects.
MICRO=/Applications/Ting.app/Contents/MacOS/ting-micro
"$MICRO" check sort-lines.yaml
printf 'b\na\nb\n' | "$MICRO" run sort-lines.yaml
"$MICRO" run dns-lookup.yaml --param domain=example.com --verbose
"$MICRO" check-configcheck-config проверяет config.json: ошибки JSON, повторные клавиши, плохие URL и id микро-приложений, которые не загружаются. Привязка микро-приложения выглядит так:
{ "key": "t", "label": "Translate", "items": [
{ "key": "a", "label": "Translate to German", "micro": "translate-german" }
]}Безопасность
Микро-приложение работает от вашего имени, со всеми вашими правами и без песочницы: оно может читать и менять файлы, работать с сетью и запускать программы. Поэтому Ting запускает файл только после того, как вы одобрите именно этот текст, и спрашивает снова после любого изменения файла или его библиотеки. Одобряйте только то, что понимаете, и оставьте запись в ~/.config/ting/ только своей учётной записи.