The MacOS desktop UI is shown in the illustrations below.
Download and launch the installer for your OS (Linux , MacOS, or Windows).
Click “Next” once you have read the welcome message from Bob Swift.
Accept the End User License Agreement (EULA) and click “Next”.
If you do not wish to accept the EULA select “I do not accept the agreement” and click “Next” or click “Cancel”.
Select where you wish to install the Bob Swift CLI. This defaults to the folder “ACLI” underneath your user directory.
Optionally enroll in a getting started email newsletter subscription. Clear the checkbox to decline enrollment.
If your installation directory contains a Bob Swift CLI installation prior to 9.2, then you will be prompted to confirm whether to overwrite it and given the option for the installer to make backups of user modifiable files.
Choose how you would like to initially configure the Bob Swift CLI installation and then click “Next”. Based on your selection the installer may prompt you for additional connection properties:
Configure CLI connections for:
Atlassian’s Cloud (Jira + Confluence)
Configure the CLI to connect to an Atlassian hosted instance of Jira (and Confluence if subscribed).
Self hosted server(s)
Choose this option if you self-host (in your own data center or in a private cloud) the Server or Data Center editions of Jira and/or Confluence.
None (skip this configuration)
The installer will configure example CLI connections, but will not prompt for any additional connection properties.
Add your installation directory to the user path…
The installer will configure your environment to make it easier to launch the Bob Swift CLI from any location on your desktop.
Run a simple test of the CLI to verify it is working.
The installer will use the configuration information from this dialog to create a test script to verify the CLI installed correctly.
The next installer dialogs will vary based on your CLI connections selection in the previous dialog:
Atlassian Cloud (Jira + Confluence)
Jira URL: The web address of your Atlassian hosted Jira instance.
Connection name (no spaces): A nickname for this connection for easy reference when issuing CLI commands to be executed using this connection.
Login required: Indicates if the Jira instance requires a user email and API token to connect or not (aka anonymous access).
User Email: The email address of the user account with which the CLI should connect.
API token: The API token of the user account with which the CLI should connect. API tokens are required by the Atlassian cloud to connect (login) when not using a web browser.
Self hosted server(s)
This applies to both Jira and Confluence.
Jira URL: The web address of your self hosted instance.
Connection name (no spaces): A nickname for this connection for easy reference when issue CLI commands to be executed using this connection.
Login required…: Indicates if the Jira instance requires a user name and password to connect or not (aka anonymous access).
User Name: The user account name with which the CLI should connect.
Password: The password for the user.
The installer is now to ready to install the Bob Swift CLI and apply your configuration preferences.
The Installer will show progress of setup.
If you chose “Run a simple test of the CLI to verify it is working” earlier you will see the results of the test. The test results will vary based on your earlier configuration selections.
Once concluded, the Installer presents an option to view the readme file for the installed release.
You can now launch the Bob Swift CLI:
From the Desktop shortcut or Start menu in Windows
The Launchpad on MacOS.
The console command: acli in Linux, MacOS, and Windows.
Installing on Linux servers
Note: This applies to Linux servers without a graphical desktop environment. The Linux installer will not run in the MacOS terminal.
Click to expand
Mark the installer file as executable: chmod +x ./ACLI-9.3.0-installer.run
Start the installer with the following command: ./ACLI-9.3.0-installer.run
The installer will present a welcome message from Bob Swift and prompt to review the End User License Agreement (EULA).
____ __ _____ _ ______
/ __ )____ / /_ / ___/ __(_) __/ /_
/ __ / __ \/ __ \ \__ \ | /| / / / /_/ __/
/ /_/ / /_/ / /_/ / ___/ / |/ |/ / / __/ /_
/_____/\____/_.___/ /____/|__/|__/_/_/ \__/
___ __ __ _ __
/ | / /_/ /___ ___________(_)___ _____ / | ____ ____ _____
/ /| |/ __/ / __ `/ ___/ ___/ / __ `/ __ \ / /| | / __ \/ __ \/ ___/
/ ___ / /_/ / /_/ (__ |__ ) / /_/ / / / / / ___ |/ /_/ / /_/ (__ )
/_/ |_\__/_/\__,_/____/____/_/\__,_/_/ /_/ /_/ |_/ .___/ .___/____/
----------------------------------------------------------------------------
You're a few clicks away from unleashing hundreds of unique, automated actions
across your Atlassian tools.
Since I first started developing the CLI clients in 2007, we've added support
for hundreds of unique actions across Jira, Confluence, Bitbucket, Bamboo, and
more.
I think you'll find that once you have this much control at your fingertips,
you'll want to automate more and more tasks to save time, cut down on manual
work, and standardize your processes. And if you have any questions, please
don't hesitate to reach out. We're here to help!
Thank you for inspiring us to create great products.
You're the reason we build software! :)
- Bob Swift
----------------------------------------------------------------------------
Please review the end user license agreement and accept the agreement in order
to proceed with the installation. The Bob Swift CLI client distribution and CLI
add-ons includes a variety of open source libraries. Those licenses may be
found in the license folder beneath the installation folder.
Press [Enter] to continue:
Review the EULA and press enter/return to proceed. Type ‘y' and press enter/return to accept or 'n’ and press enter/return to decline and cancel the installation.
Copyright (c) 2005, 2020 Appfire Technologies, Inc.
All rights reserved.
This software is licensed under the provisions of the "Bob Swift Atlassian App
EULA"
(https://bobswift.atlassian.net/wiki/x/WoDXBQ) as well as under the provisions
of
the "Standard EULA" from the "Atlassian Marketplace Terms of Use" as a
"Marketplace Product"
(http://www.atlassian.com/licensing/marketplace/termsofuse).
Press [Enter] to continue:
Do you accept this license? [y/n]:
Specify where you wish to install the Bob Swift CLI. This defaults to the folder “ACLI” underneath your user directory. Optionally type a new destination and press enter/return. Press enter/return without typing to accept the default.
----------------------------------------------------------------------------
Please specify the directory where Bob Swift Command Line Interface (CLI) will
be installed.
Installation Directory [/home/bobswift/ACLI]:
Optionally enroll in a getting started email newsletter subscription. Type ‘n' and enter/return to decline enrollment. Otherwise type 'y’ and/or enter/return to provide your contact information.
May we send you helpful getting started articles? [Y/n]:
----------------------------------------------------------------------------
Get help getting started
We have a wealth of knowledge we'd like to share with you to get the most out of
the CLI.
Email: []: bobswift@examplegear.com
First name []: Bob
Last name []: Swift
If your installation directory contains a Bob Swift CLI installation prior to 9.2, then you will be prompted to confirm whether to overwrite it and given the option for the installer to make backups of user modifiable files.
Overwrite existing CLI files [y/N]: y
----------------------------------------------------------------------------
The installer found evidence of what appears to be a previous CLI installation
in /home/bobswift/ACLI.
The installation can make backups (.bak) of properties files and scripts. It
will remove no longer needed files in the lib folder, and replace files found in
the license folder.
If you wish to preserve any files seperately, please make a backup of them
before proceeding with the installation.
Create backup (.bak) files [y/N]:
Choose how you would like to initially configure the Bob Swift CLI installation and then click “Next”. Based on your selection the installer may prompt you for additional connection properties.
In the illustration below option 1 (Atlassian’s Cloud (Jira + Confluence) is selected.
Configure CLI connections for:
Atlassian’s Cloud (Jira + Confluence)
Configure the CLI to connect to an Atlassian hosted instance of Jira (and Confluence if subscribed).
Self hosted server(s)
Choose this option if you self-host (in your own data center or in a private cloud) the Server or Data Center editions of Jira and/or Confluence.
None (skip this configuration)
The installer will configure example CLI connections, but will not prompt for any additional connection properties.
Add your installation directory to the user path…
The installer will configure your environment to make it easier to launch the Bob Swift CLI from any location on your desktop.
Run a simple test of the CLI to verify it is working.
The installer will use the configuration information from this dialog to create a test script to verify the CLI installed correctly.
----------------------------------------------------------------------------
Installation options
Configure CLI connection(s) for:
[1] Atlassian's Cloud (Jira + Confluence)
[2] : Self hosted server(s)
[3] None (skip configuration)
Please choose an option [1] :
Atlassian's Cloud (Jira + Confluence)
Add '/home/bobswift/ACLI' to the user path so you can run the CLI from any
directory. [Y/n]:
Run a simple test of the CLI to verify it is working. [Y/n]:
Provide CLI connection properties:
Configuration options in the illustration below continue to reflect option 1 (Atlassian’s Cloud (Jira + Confluence) from the previous step.
Jira URL: The web address of your Atlassian hosted Jira instance.
Connection name (no spaces): A nickname for this connection for easy reference when issuing CLI commands to be executed using this connection. Defaults to ‘default’.
Login required…: Indicates if the Jira instance requires a user email and API token to connect or not (aka anonymous access). Defaults to 'Y'.
User Email: The email address of the user account with which the CLI should connect.
API token: The API token of the user account with which the CLI should connect. API tokens are required by the Atlassian cloud to connect (login) when not using a web browser.
----------------------------------------------------------------------------
Configure your Jira connection
Jira URL []: https://bobswift.atlassian.net
Connection name (no spaces) [default]:
Login required (Untick to connect anonymously) [Y/n]:
----------------------------------------------------------------------------
User Email []: bobswift@examplegear.com
API token []: a61df446ac90468fb2b8839831938e18
The installer is now to ready to install the Bob Swift CLI and apply your configuration preferences.
----------------------------------------------------------------------------
Setup is now ready to begin installing Bob Swift Command Line Interface (CLI) on your computer.
Do you want to continue? [Y/n]:
The installer will now show progress of setup.
----------------------------------------------------------------------------
Please wait while Setup installs Bob Swift Command Line Interface (CLI) on your computer.
Installing
0% ______________ 50% ______________ 100%
########################################
If you chose “Run a simple test of the CLI to verify it is working” earlier you will see the results of the test. The test results will vary based on your earlier configuration selections.
Info: Now testing the Bob Swift CLI.
In the next screen you will see the
results of the CLI gathering information about your CLI configuration.
Press [Enter] to continue:
CLI Testing Results
Below are the results of testing the CLI using the configuration information
provided earlier.
Client information
Client name . . . . . . . . . : cli
Client version . . . . . . . : 9.3.0-SNAPSHOT
Client description . . . . . : Base client for the Atlassian Command Line
Interface.
Client usage . . . . . . . . : The cli client is the base for all other clients
and defines common actions and parameters.
OS name . . . . . . . . . . . : Linux
OS version . . . . . . . . . : 5.0.0-38-generic
Java name . . . . . . . . . . : OpenJDK 64-Bit Server VM
Java version . . . . . . . . : 11.0.6
Java arguments . . . . . . . : -Dfile.encoding=UTF-8
Used memory (MB) . . . . . . : 3
Free memory (MB) . . . . . . : 12
Total memory (MB) . . . . . . : 15
Max memory (MB) . . . . . . . : 237
Default encoding . . . . . . : UTF-8
Configuration file . . . . . : /home/bobswift/ACLI/acli.properties
Server info
Product . . . . . . . . . . . : Jira
Hosting . . . . . . . . . . . : cloud
Version . . . . . . . . . . . : 1001.0.0-SNAPSHOT
Base URL . . . . . . . . . . : https://bobswift.atlassian.net
Title . . . . . . . . . . . . : Jira for Bob Swift Atlassian Apps
Build . . . . . . . . . . . . : 100122
Build date . . . . . . . . . : 3/18/20, 12:44 AM
Current time . . . . . . . . :
License information . . . . . : Not available for this Cloud instance.
Client . . . . . . . . . . . : jiracloud
User . . . . . . . . . . . . : anonymous
Response time (milliseconds) : 982
Press [Enter] to continue:
Once concluded, the Installer presents an option to view the readme file for the installed release. Defaults to 'Y'.
----------------------------------------------------------------------------
Setup has finished installing Bob Swift Command Line Interface (CLI) on your computer.
View Readme file? [Y/n]:
You can now launch the Bob Swift CLI via the console command: acli.
