From 5c4f27b7166360bd23709f24642b247eac30a147 Mon Sep 17 00:00:00 2001
From: PascalKont <pascal@kontschan.de>
Date: Wed, 25 Feb 2026 11:42:24 +0100
Subject: [PATCH] feat(molecule): introduce molecule aliases (#13594)

---
 plugins/molecule/README.md           | 13 ++++++++++++-
 plugins/molecule/molecule.plugin.zsh |  8 ++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/plugins/molecule/README.md b/plugins/molecule/README.md
index 27b21f941..5c4476626 100644
--- a/plugins/molecule/README.md
+++ b/plugins/molecule/README.md
@@ -1,9 +1,20 @@
 # Molecule plugin
 
-This plugin adds completion for [Molecule](https://ansible.readthedocs.io/projects/molecule/), the project designed to aid in the development and testing of Ansible roles..
+This plugin adds aliases and completion for [Molecule](https://ansible.readthedocs.io/projects/molecule/), the
+project designed to aid in the development and testing of Ansible roles..
 
 To use it, add `molecule` to the plugins array in your zshrc file:
 
 ```zsh
 plugins=(... molecule)
 ```
+
+## Aliases
+
+| Alias | Command           | Description                                                                        |
+| :---- | :---------------- | ---------------------------------------------------------------------------------- |
+| mol   | molecule          | Molecule aids in the development and testing of Ansible roles.                     |
+| mcr   | molecule create   | Use the provisioner to start the instances.                                        |
+| mcon  | molecule converge | Use the provisioner to configure instances (dependency, create, prepare converge). |
+| mls   | molecule list     | List status of instances.                                                          |
+| mvf   | molecule verify   | Run automated tests against instances.                                             |
diff --git a/plugins/molecule/molecule.plugin.zsh b/plugins/molecule/molecule.plugin.zsh
index 65ba85e64..cee25ab03 100644
--- a/plugins/molecule/molecule.plugin.zsh
+++ b/plugins/molecule/molecule.plugin.zsh
@@ -12,3 +12,11 @@ if [[ ! -f "$ZSH_CACHE_DIR/completions/_molecule" ]]; then
 fi
 
 _MOLECULE_COMPLETE=zsh_source molecule >| "$ZSH_CACHE_DIR/completions/_molecule" &|
+
+# Alias
+# molecule: https://docs.ansible.com/projects/molecule/
+alias mol='molecule'
+alias mcr='molecule create'
+alias mcon='molecule converge'
+alias mls='molecule list'
+alias mvf='molecule verify'