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.7.6/docs/CONFIGURING.md) і FORMAT.md (https://github.com/bobuk-io/ting/blob/v0.7.16/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. |
context | Що Ting читає під час запуску: app, finder, browser, selection, window (див. «З чим ви працювали»). |
command або steps | Одна команда оболонки або список кроків (нижче). |
output | to: [clipboard, panel] (або app: вставити в застосунок, з якого ви прийшли) і 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 | Запускає бібліотеку (див. «Бібліотеки»). |
keys | Натискає клавіші в застосунку, з якого ви прийшли, наприклад cmd+t або [cmd+a, return]. |
paste | Вставляє текст у цей застосунок і повертає буфер обміну. |
Кожен крок може мати 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))Перевірити стан вікна lowkey
Потрібна збірка Ting, у якій FORMAT.md описує крок lowkey, і застосунок lowkey з утилітою lowkeyctl у /Applications. Замініть notes своїм аліасом. Приклад покаже стан вікна, не відкриваючи сторінку. Щоб отримати список елементів уже відкритої сторінки, замініть status на inspect. Починаючи з Ting 0.7.16 і lowkey 0.1.2, другий приклад зберігає відкритий демо-сайт у PDF формату A4 зі стилями друку. Потрібен збережений origin. Наявний файл не перезаписується. Відкладений вміст не завантажується, віртуальні списки не розгортаються.
format: ting.microapp/2
description: Show the state of a saved lowkey window.
input: none
steps:
- lowkey: notes
action: status
as: json
output:
to: [panel]
as: codeformat: ting.microapp/2
description: Save a demo page as PDF.
input: none
timeout: 60
steps:
- lowkey: demo
action: save-pdf
file: ~/Desktop/demo-page.pdf
timeout: 60Ting 0.7.4: choose та ask
У Ting 0.7.4 з’явилися ці інтерактивні кроки. Доступні кроки перевіряйте за FORMAT.md усередині встановленого Ting.
choose показує список із попереднього кроку з фільтром: один варіант на непорожній рядок або JSON-масив рядків чи об’єктів із title, необов’язковим subtitle та рядковим value. Наступний крок отримує вибране значення. Стрілки вибирають, Return підтверджує. Навіть один варіант потребує підтвердження; порожній список зупиняє запуск.
ask запитує текст у потрібному місці сценарію. Він приймає default (зі змінними), placeholder, multiline та required. За замовчуванням поле порожнє, обов’язкове й однорядкове. Для редагування попереднього виводу явно вкажіть default: ${input}. Return продовжує; з multiline: true він додає рядок, а Command-Return продовжує.
Якщо вказано id, відповідь доступна пізніше як ${steps.ID}. Esc скасовує весь запуск. Відповіді не запам’ятовуються; очікування призупиняє таймаути виконання, зокрема всередині бібліотек. Потрібна панель Ting: ting-micro check перевіряє такі файли, але ting-micro run відхиляє їх до виконання першого кроку.
format: ting.microapp/2
description: Choose a question and write notes.
input: none
steps:
- text: |
What should change?
What already works?
- choose: Choose a question
id: question
- ask: Your notes
placeholder: Enter details
multiline: true
required: false
- text: |
Question: ${steps.question}
Notes: ${input}
output:
to: [panel]Ting 0.7.6: історія Clipbawd
Використовуйте ${clipboard[-1]} для найновішого запису, ${clipboard[-2]} для попереднього та ${clipboard[-3]} для третього з кінця. Дозволені лише від’ємні цілі числа. Потрібен повний запис ${clipboard[-1]}, а не $clipboard[-1].
Починаючи з Ting 0.7.17 у Settings є бічна навігація та пошук. Помилки мікрозастосунків, папку, Copy Agent Prompt і доступність перенесено до Settings › Micro-apps; команда меню — до Tools › Copy Agent Prompt. Clipbawd може зберігати історію між запусками за бажанням: за замовчуванням 100 записів, 50 MiB і 30 днів. Знімки історії можуть містити відео; текстові шаблони явно відхиляють такі записи, як і зображення.
Схвалений запуск отримує незмінний знімок після форми параметрів; копіювання під час виконання не змінює індекси. Текст, посилання й кольори повертають текст, файли — шляхи через новий рядок. Зображення, відсутні записи, вимкнена історія та консольний ting-micro run дають явну помилку. Індекси враховують і зображення, не пропускаючи їх. Виключення Clipbawd діють; панель схвалення повідомляє про читання історії.
Використовуйте шаблони в полях кроків чи env:, не вставляйте історію в код shell або Python. Беріть змінну shell у лапки. Працюють і фільтри: ${clipboard[-1]|trim|url}.
format: ting.microapp/2
description: Show the preceding clipboard history entry
input: none
steps:
- command: 'printf "%s" "$CLIP"'
env:
CLIP: ${clipboard[-2]}
output:
to: [panel]Змінні
Будь-яке значення кроку, крім коду оболонки та Python, може містити змінні:
| Змінна | Значення |
|---|---|
${input} | Вхід кроку. |
${params.NAME} | Параметр. |
${steps.ID} | Вивід одного з попередніх кроків. |
${NAME} | Змінна вашої оболонки входу, наприклад ${OPENAI_API_KEY}. |
${keychain.SERVICE} | Пароль із вашої зв’язки ключів. |
${context.SOURCE.FIELD} | Значення контексту, наприклад ${context.app.name}. |
Фільтри після |: url (кодування для URL), json (екранування для рядка JSON), trim, base64. Наприклад, ${input|trim|url}.
Ting ніколи не підставляє текст у код оболонки та Python. Код читає ті самі значення із середовища: $TING_NAME для параметрів, $TING_STEP_ID для виводу кроків, $TING_CONTEXT_SOURCE_FIELD для контексту і змінні, задані в env:. Так текст із буфера обміну не може стати командою.
З чим ви працювали
З Ting 0.6.0 мікрозастосунок може дізнатися, що було на екрані під час запуску: перелічіть джерела в context:, і Ting прочитає лише їх, до панелі параметрів. Кроки читають значення як ${context.SOURCE.FIELD}, код — як $TING_CONTEXT_SOURCE_FIELD.
| Джерело | Значення | Дозвіл |
|---|---|---|
app | name, bundle, path, pid активного застосунку | не потрібен |
finder | selection (по шляху на рядок) і folder переднього вікна Finder, навіть якщо Finder у фоні | автоматизація для Finder |
browser | url, title передньої вкладки й name браузера: Safari, Chrome, Arc, Brave, Edge, Vivaldi або Chromium | автоматизація для браузера |
selection | text: виділений текст; якщо доступність його не віддає, Ting натискає Command-C і повертає буфер обміну | доступність |
window | title і document переднього вікна | доступність |
Мікрозастосунок може й надсилати введення в застосунок, з якого ви прийшли: keys натискає клавіші, paste вставляє текст, а output з to: [app] вставляє результат. Цей мікрозастосунок сортує виділені рядки на місці:
format: ting.microapp/2
name: Sort selected lines
description: Sort the lines of the selected text and put them in place of the selection.
tools: [sort]
context: [selection]
input: none
steps:
- command: LC_ALL=en_US.UTF-8 sort
stdin: ${context.selection.text}
output:
to: [app]А цей відкриває нову вкладку браузера й шукає там текст із буфера обміну:
input: clipboard
steps:
- keys: cmd+t
- paste: ${input|trim}
- keys: returnmacOS один раз запитає, чи можна Ting керувати Finder або браузером; без цього мікрозастосунок не запускається, а панель каже, що треба дозволити. Без доступності Ting відкриває вікно, яке показує, як її ввімкнути: перетягніть іконку Ting із вікна до списку доступності в налаштуваннях приватності й безпеки. Чи має Ting доступ, видно в Settings › Advanced.
Бібліотеки
Кроки, спільні для кількох мікрозастосунків, зберігаються один раз у ~/.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. Контекст він не читає: значення задаються через --context app.name=Safari. Кроки keys і paste там нічого не надсилають.
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" run sort-selection.yaml --context "selection.text=$(printf 'b\na')"
"$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/ лише своєму обліковому запису. Мікрозастосунок, який натискає клавіші чи вставляє текст, може зробити в передньому застосунку все, що ви робите клавіатурою: схвалюйте його так само уважно, як код.