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/ лише своєму обліковому запису.