Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

The first step is to install the WA2 cli1 intent. You’ll need an internet connection for the download. Since intent is a Rust binary it’s a single file to install, or delete.

Tip

WA2 must be trustworthy to be useful, so it is open source. You should follow your security policies, and trust but verify before installing. You can view the source code for the book2, installation script3, and tooling4.

The following steps install the latest release5 of WA2 intent, and this book assumes that version.

Linux or macOS

Note

We are assuming you place developer binaries in ~/.local/bin. You can place the intent binary wherever you want, but ensure it’s on your PATH.

If you’re using Linux or macOS, open a terminal and run:

curl -fsSL https://well.architected.to/install-intent.sh | sh

This script will:

  • detect your platform and CPU architecture
  • download the correct release from https://github.com/unremarkable-technology/tooling/releases
  • install the intent binary to ~/.local/bin

After installation, verify:

intent --version
intent 0.2.0

If the command is not found, ensure ~/.local/bin is on your PATH.

Windows

WSL 2

Install using the same command as Linux:

curl -fsSL https://well.architected.to/install-intent.sh | sh

Verify:

intent --version
intent 0.2.0

If the command is not found, ensure ~/.local/bin is on your PATH.

PowerShell

Note

We are assuming you place developer executables in %USERPROFILE%\bin. You can place the intent.exe wherever you want, but ensure it’s on your PATH.

Download the latest release. The following command assumes you have PowerShell available:

iwr https://github.com/unremarkable-technology/tooling/releases/latest/download/intent-win32-x64.zip -OutFile intent.zip
Expand-Archive intent.zip -DestinationPath $env:USERPROFILE\bin -Force

Then verify:

intent --version
intent 0.2.0

After installation you should be able to run intent from any terminal.


  1. Command Line Interface

  2. https://github.com/unremarkable-technology/book

  3. https://well.architected.to/install-intent.sh

  4. https://github.com/unremarkable-technology/tooling

  5. https://github.com/unremarkable-technology/tooling/releases/latest/