How Commands Work
Tuna is built like a sentence.
You pick a subject. Then an action. Sometimes you also pick a target.
That is the whole thing.
Subject
The subject is one or more items.
Items might be:
- an app
- a file
- a set of files
- a folder
- a piece of text
- a clipboard item
- a meta item like "current finder selection"
Action
The action is what to do with the subject.
Examples:
- open it
- reveal it
- copy it
- move it
- run it
- transform it
Some actions are final. Some actions need one more thing.
Target
The target is the optional third part.
Examples:
-
Safari->Open File...->invoice.pdf -
photo.gif->Open With...->Firefox -
hello->Append to File->notes.txt -
hello->Send to Smart Link...->GitHub Search
If an action does not need a target, the command stops at the action.
Why This Matters
This is what makes Tuna composable.
You are not memorizing a thousand unrelated commands. You are moving through the same structure over and over:
- find a thing
- choose what to do
- optionally choose where it goes
All four modes feed into this:
- Fuzzy Mode finds things fast
- Text Mode creates text as a subject
- Talk Mode gets spoken words into text
- Leader Mode jumps straight into known commands
That is why Tuna can stay predictable even when it grows.