bobuk.io
← Все приложения

Ting / Микро-приложения

Микро-приложения: свои инструменты на клавише

Микро-приложение — небольшой YAML-файл, который Ting запускает по клавише. Он читает буфер обмена или то, с чем вы работали, спрашивает несколько значений, выполняет код оболочки или Python, HTTP-запросы или обращается к модели ИИ и показывает, копирует или вставляет результат. Проще всего получить такой файл — попросить агента для программирования написать его.

Попросите агента (рекомендуем)

Изучать формат не обязательно. Агент, например Claude Code, Codex или pi, читает руководство по формату внутри Ting.app, пишет файл, проверяет его через ting-micro и кладёт на место. Он также может добавить привязку клавиши в ваш config.json.

  1. В меню Ting в строке меню выберите Copy Agent Prompt (эта кнопка есть и в Settings › Advanced). Ting скопирует готовый текст с путями вашего Mac.
  2. Запустите агента в терминале и вставьте текст.
  3. После последней строки «My task:» напишите задачу обычными словами: какая клавиша, что подаётся на вход, что должно произойти и куда деть результат.
  4. Дождитесь, пока агент закончит. Он пишет файл во временной папке, проверяет его, пока ting-micro check не ответит ok, переносит в ~/.config/ting/micro/ и проверяет config.json командой ting-micro check-config.
  5. Нажмите клавишу. 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
  1. Откройте Settings › Bindings, выберите + › Micro-app и укажите Sort lines. Или запустите его по имени из launcha.
  2. Скопируйте несколько строк и нажмите клавишу. В первый раз одобрите файл клавишами Command-Return.
  3. Отсортированные строки окажутся в буфере обмена и в панели.

Файл с ошибкой Ting не использует: меню в строке меню предупреждает, Settings › Advanced показывает ошибку с номером строки, а ~/.config/ting/micro-errors.log хранит её.

Файл

КлючЗначение
formatВсегда ting.microapp/2.
id, nameid пишется в kebab-case (sort-lines), по умолчанию это имя файла. name показывается в меню.
descriptionОдна строка, обязательно.
paramsЗначения, которые Ting спрашивает перед запуском: text или choice. Обязательные видны всегда; необязательным нужен default, они открываются по Command-O.
inputclipboard (текст идёт на вход первому шагу) или none.
contextЧто Ting читает при запуске: app, finder, browser, selection, window (см. «С чем вы работали»).
command или stepsОдна команда оболочки или список шагов (ниже).
outputto: [clipboard, panel] (или app: вставить в приложение, из которого вы пришли) и as: markdown | console | text | code. Без output ничего не показывается и не копируется.
timeoutВремя всего запуска в секундах: по умолчанию 60, максимум 300.
toolsПрограммы, которые нужны коду в PATH, например [dig, jq].
hidden, rememberhidden: 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).
urlHTTP-запрос: 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: code
format: 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: 60

Ting 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.

ИсточникЗначенияРазрешение
appname, bundle, path, pid активного приложенияне нужно
finderselection (по пути на строку) и folder переднего окна Finder, даже если Finder в фонеавтоматизация для Finder
browserurl, title передней вкладки и name браузера: Safari, Chrome, Arc, Brave, Edge, Vivaldi или Chromiumавтоматизация для браузера
selectiontext: выделенный текст; если универсальный доступ его не отдаёт, Ting нажимает Command-C и возвращает буфер обменауниверсальный доступ
windowtitle и 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: return

macOS один раз спросит, можно ли 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-config

check-config проверяет config.json: ошибки JSON, повторные клавиши, плохие URL и id микро-приложений, которые не загружаются. Привязка микро-приложения выглядит так:

{ "key": "t", "label": "Translate", "items": [
  { "key": "a", "label": "Translate to German", "micro": "translate-german" }
]}

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

Микро-приложение работает от вашего имени, со всеми вашими правами и без песочницы: оно может читать и менять файлы, работать с сетью и запускать программы. Поэтому Ting запускает файл только после того, как вы одобрите именно этот текст, и спрашивает снова после любого изменения файла или его библиотеки. Одобряйте только то, что понимаете, и оставьте запись в ~/.config/ting/ только своей учётной записи. Микро-приложение, которое нажимает клавиши или вставляет текст, может сделать в переднем приложении всё, что вы делаете клавиатурой: одобряйте его так же внимательно, как код.