Learning, Aliases, and Defaults

Tuna gets more useful the longer you use it.

Tuna remembers the choices you make inside the same command system described in How Commands Work.

Learning

When you keep picking the same result for the same fuzzy query, Tuna learns from that.

So if sfi keeps meaning Safari for you, Safari will rise to the top.

The same idea applies to repeated command choices. Tuna tries to make your usual path feel like the default path.

Aliases

Learning is implicit. Aliases are explicit.

An alias is a name you choose on purpose for a result.

Aliases attach to that exact result, not just to whatever happens to share the same visible name.

That is useful when:

• you want a short mnemonic
• you want a name Tuna would never guess on its own
• you want a stable shortcut instead of waiting for ranking to settle

Examples:

• gh for your GitHub catalog
• inbox for a specific folder or list
• shrug for ¯\\_(ツ)_/¯

Defaults

Defaults tell Tuna which action or result you prefer when there are multiple valid choices.

This matters because Tuna is often deciding between:

• several matching subjects
• several reasonable actions
• several target-capable paths

Defaults help Tuna bias toward the one you actually mean most of the time.

The Difference

Use learning when Tuna is already close.

Use an alias when you want a custom name.

Use defaults when Tuna found the right thing, but keeps choosing the wrong next step.

When To Care About This

You do not need to master any of this on day one.

First learn Fuzzy Mode, Text Mode, and the basic command shape.

Then when Tuna starts feeling almost right but not quite personal yet, come back here.

That is the point where learning, aliases, and defaults stop feeling like settings and start feeling like the reason Tuna fits you.