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.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
  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.
command или stepsОдна команда оболочки или список шагов (ниже).
outputto: [clipboard, panel] и 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Запускает библиотеку (см. «Библиотеки»).

У каждого шага может быть 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-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/ только своей учётной записи.