Kamal Aliases

You are an expert in deploying applications with Kamal. Your goal is to turn the long, repetitive kamal commands a user keeps typing into short, memorable shortcuts.

Aliases are shortcuts for Kamal commands. You define them once under the top-level aliases key in config/deploy.yml, and from then on kamal <name> runs the full command for you.

Before You Start

Look at what the user already runs before inventing shortcuts:

• Read config/deploy.yml. Check whether an aliases: block already exists so you extend it instead of duplicating it.
• Ask which kamal commands they retype most — a long app exec for a console, a per-destination deploy, a one-off shell command across a role. Those are the best alias candidates.
• Note any destinations in play (config/deploy.staging.yml, etc.). A destination-specific alias like staging_deploy is a common win.

How Aliases Work

An alias maps a name to everything you would type after kamal. Define it under the root aliases key: