---
title: "Command Builder"
canonical: "https://support.appfire.com/space/ACLI/60559226/Command%20Builder"
format: markdown
---
# Description

With the Atlassian CLI v9.5, the Bob Swift team introduces Command Builder - a new text-based UI that provides prompts, helps discover actions, walks through available parameters, completes content, and creates a ready-to-run command.

Watch this quick [What's New](https://www.youtube.com/watch?v=roAd5dI--d0)[ video](https://www.youtube.com/watch?v=roAd5dI--d0) to learn more or dive right in by following the instructions below.

# How it works

In this example, we're going to use the Command Builder to create a command that will help us add a group "Board Admins" as board administrators to a board titled "My Board."

On the command line, run the command ***aclibuilder***. Command Builder will display help:

![image](media://09b90eae-05fb-4012-bece-8f9ff94672ae)

  
Capabilities of the Command Builder are organized in topics. Topics have three tiers: 

Clients → Categories → Actions

Adding a client topic on the command line (***aclibuilder agile***) displays the action categories for that topic:

> Macro (inline-media-image)

  
  
  
Actions for the category can be listed by adding the category name to the end of the client name separated by ":" *(****aclibuilder agile:boards****):*

> Macro (inline-media-image)

  
  
  
To start building an ACLI command add the desired action to the command (***aclibuilder agile:boards:addBoardAdministrators***):

> Macro (inline-media-image)

  
  
  
The purple text explains the required parameters you must provide in order to run the *addBoardAdministrators* action. In this case, the required parameters are "(board or id), (userId or group)". 

This is read as: *Select the board or id parameter as well as the userId or group parameter*.

Use the arrow keys to highlight each parameter and press *return* or *enter* to select it.

![image](media://b60abdb6-2562-4045-a0b7-7a8f2a520418)

  
Once selected the Command Builder prompts for the parameter value. Press *return* or *enter* to save the value.

![image](media://7eef5612-bc43-4fcb-a752-aa9c45a7b6a4)

  
While selecting parameters and providing values the Command Builder displays a preview of the command being built and removes parameters already selected (excluding parameters that can be specified multiple times):

![image](media://bde57d16-fce1-42aa-a58d-712fd31c7e53)

  
The Command Builder will continue to present required and optional parameters to select until all parameters are provided or the *esc* key is pressed to stop selecting parameters. The Command Builder then presents the complete command and prompts to copy the command to the clipboard. Pressing "Y" or *return* or *enter* will copy the command to the clipboard.

![image](media://0c1b516b-23a0-4b5a-b0d8-a76b489827b5)

  
Once copied, the command can be pasted to the command line or a script file for executing when needed.

![image](media://c81343fe-abad-42af-9e7a-1b0a4e2bcece)

  
And that's it! Congrats, you just built your first command with the Command Builder.