the task takes a destination

output_dir, optional. absent, the text lands beside the recording as it
always has — that is what a person right-clicking a memo wants and it is
not changing. given, the transcript goes there instead, and the directory
is created if it does not exist.

for callers that are not a person clicking a file. a commander keeps its
results in its own directory, and the alternative was making every
commander move the file afterwards: a step in the loop forever, plus a
window where the file sits in the folder being watched.

marked `hidden` so the file browser neither shows it nor counts it as
something to ask about — without that, declaring it turned a direct
right-click run back into a modal with a field nobody clicking a file has
an answer for.
This commit is contained in:
2026-08-25 04:56:43 +00:00
parent dd3dbb611b
commit 8c0366fdbc
2 changed files with 36 additions and 11 deletions
+9 -2
View File
@@ -15,6 +15,13 @@ inputs:
- name: file_path
description: Path to the audio file to transcribe. Auto-filled from the file browser.
required: true
- name: output_dir
description: >-
Where to write the transcript. Absolute, or relative to the recording. Leave it out and the text
lands beside the recording, which is what a person clicking a file wants. A commander passes its own
directory so its results never land in the folder it watches.
required: false
hidden: true
trigger:
- type: file
extensions:
@@ -38,8 +45,8 @@ model call spent re-deriving what the plugin already returns.
(`GET /api/user/settings`).
2. `POST` the file to `/api/transcribe/transcribe`. The plugin detects the language and transcribes
faithfully in it — see `plugins/transcribe/skills/transcribe/SKILL.md` for the contract.
3. Write the transcription beside the audio file, same name, `.md`. Nothing is moved and nothing is
created around it.
3. Write the transcription as `.md` with the same base name — beside the recording by default, or into
`output_dir` when one is given. The directory is created if it does not exist.
It overwrites a previous transcription of the same file, deliberately: a transcription is derived, and
running it again means you wanted it again.