The purpose of this help article is to get started using the Crusoe Command Line Interface (CLI) on MacOS. The CLI is useful in order to get started with terraform, manage your cloud resources from a local terminal, and helpful in troubleshooting to help set up Serial Console Access. 

Instructions

1. Install Homebrew > https://brew.sh/ or run below command.
   

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Run below command to install crusoe CLI
   

   brew install crusoecloud/cli/crusoe

3. Enable auto completion for easy use. Add the following to `~/.zshrc`
   

   fpath=(~/.zsh/completion $fpath)
   autoload -Uz compinit
   Compinit

4. Run below commands 
   

   crusoe completion zsh > .zsh/completion/ _crusoe
   source ~/.zshrc 

5. Go to  Security Page and create a Token and note your `access_key_id` and `secret_key`.
6. View all of your projects anytime in the Console on the Projects page.
   
   
7. In `~/.crusoe/config` add following details with your `project_name`, `access_key_id`, `secret_key`

   crusoe config set default_project <project_name>
   crusoe config set access_key_id <access_key_id>
   crusoe config set secret_key <secret_key>

8. This file should look like below:
   

   [default]
    default_project = "<project_name>"
    access_key_id = "<access_key_id>"
    secret_key = "<secret_key>"

9. Verify if the Crusoe CLI is working properly

   crusoe -h

10. If you've properly installed and configured the CLI, you should be able to run the below command to see the logged-in user:
    

    crusoe whoami
    <Full name> user@domain.com
    

11. To upgrade to a newer version of the CLI.

    brew upgrade crusoe

References
1. https://docs.crusoecloud.com/quickstart/installing-the-cli

2. https://docs.crusoecloud.com/compute/virtual-machines/accessing-vms#using-the-serial-console 

3. https://support.crusoecloud.com/hc/en-us/articles/31414442869275-How-To-Set-Up-Crusoe-CLI-on-Windows