Install Attini CLI


Installation time: ca 1 minute

Prerequisites

Attini CLI depends on:

  1. AWS CLI (If you are using AWS SSO you need AWS CLI version 2).

  2. Configured AWS CLI credentials.

If you ever used the AWS CLI in your AWS accounts before this step is already finished.


Installation and update

Admin/Root installation

rm -f /usr/local/bin/attini; curl -L#o /usr/local/bin/attini https://docs.attini.io/api/v1/cli/get-cli/$(uname -m)/$(uname -s)/latest; chmod +x /usr/local/bin/attini

If you are not currently logged in as admin or root on your operating system you will need to use the sudo command, please use the line below:

sudo rm -f /usr/local/bin/attini; sudo curl -L#o /usr/local/bin/attini https://docs.attini.io/api/v1/cli/get-cli/$(uname -m)/$(uname -s)/latest; sudo chmod +x /usr/local/bin/attini

Verify the installation


Non Admin/Root installation

  1. Create or find a directory in your home folder that is on your system path.

  2. Configure the script below with your path from step 1.

LOCAL_PATH=~/bin
rm -f ${LOCAL_PATH}/attini; curl -L#o ${LOCAL_PATH}/attini https://docs.attini.io/api/v1/cli/get-cli/$(uname -m)/$(uname -s)/latest; chmod +x ${LOCAL_PATH}/attini

Verify the installation


Setup Attini CLI autocomplete

After you installed the Attini CLI, you can activate autocomplete by running this command:

source <(attini generate-completion)

If you have any issues with this command, see our common issues section.

To automatically run this command in new shells do the following:

RC_FILE=~/."${SHELL##*/}"rc;
echo "Adding attini auto complete to $RC_FILE"
echo 'source <(attini generate-completion)' >> $RC_FILE;

Note

If you are using zsh you might get this warning:

zsh compinit: insecure directories, run compaudit for list.
Ignore insecure directories and continue [y] or abort compinit [n]?

Fix this with this script:

compaudit | xargs chmod go-w

This command limits the access to some system files that zsh warns you about. We recommend that you do your own research regarding this issue or talk to your company’s systems administrators for approval before applying this fix.


Trouble shot the installation

If the Attini CLI is not working, please follow these steps:

  1. See if you can find the error in our common issues section.

  2. Run uname -m and uname -s in your terminal and verify that your computer is supported by the Attini CLI, see Supported platforms.

  3. If your computer should be supported but are still having issue, please report this to support@attini.io.

  4. If your computer is not supported, please send a feature request to us on support@attini.io.


Windows installation

The Attini CLI does not currently support Windows. We recommend Windows users to use Windows Subsystem for Linux then follow the Linux installation guide. Running Linux on a virtual machine ex, virtualbox is also a viable option.


Create a directory on your path that does not require root/admin access

The example blow will create a directory called “bin” in your one home. This is a standard directory for non root binary’s, however you can name your directory whatever you like.

LOCAL_PATH=~/bin;
mkdir -p $LOCAL_PATH;
export PATH="$HOME/bin:$PATH";
RC_FILE=~/."${SHELL##*/}"rc;
echo "Adding $LOCAL_PATH to System path in $RC_FILE"
echo 'export PATH="$HOME/bin:$PATH"' >> $RC_FILE;

Verify the installation

Verify the installation by running:

attini --version

Uninstall the Attini CLI

To uninstall the Attini CLI you just need to delete the attini file on your path.

rm `which attini`

If you have enabled Attini ClI autocomplete you should remove the line source <(attini generate-completion) from your ~/.bashrc or ~/.zshrc file.


Supported operating systems and CPU architectures

Attini CLI works the operating systems:

  • Darwin (Mac)

  • Linux

Attini CLI works with the following CPU architectures:

  • x86_64

  • aarch64

  • Mac M1 chip

Note

We plan to build support for more operating systems and CPU architectures. If you have any requirements please send an email to support@attini.io and we will try to prioritize accordingly.

You can find your operating system and CPU Architecture by running uname -s and uname -m in a terminal. Please include this information in the support email.


Attini CLI Information API

List the available operating systems and cpu architectures:

curl https://docs.attini.io/api/v1/cli/get-supported-platforms

Get available Attini CLI versions:

curl https://docs.attini.io/api/v1/cli/get-cli-versions/{cpu_architecture}/{operating_systems}

Examples:

curl https://docs.attini.io/api/v1/cli/get-cli-versions/$(uname -m)/$(uname -s)
curl https://docs.attini.io/api/v1/cli/get-cli-versions/x86_64/Linux
curl https://docs.attini.io/api/v1/cli/get-cli-versions/x86_64/Darwin

Get re-routed to the Attini CLI location:

curl https://docs.attini.io/api/v1/cli/get-cli/{cpu_architecture}/{operating_systems}/{version}

Examples:

curl https://docs.attini.io/api/v1/cli/get-cli/$(uname -m)/$(uname -s)/latest
curl https://docs.attini.io/api/v1/cli/get-cli/x86_64/Linux/1.0.1
curl https://docs.attini.io/api/v1/cli/get-cli/x86_64/Darwin/1.0.0