From a36db44ce568ac4ae1ca41d8496ec31cf2f0f24a Mon Sep 17 00:00:00 2001 From: anupras-mohapatra-arm Date: Mon, 29 Jun 2026 16:47:28 -0500 Subject: [PATCH 1/3] first pass Kiro CLI refactor, including a heading update based on search console insight --- content/install-guides/kiro-cli.md | 76 ++++++++++++++++-------------- 1 file changed, 41 insertions(+), 35 deletions(-) diff --git a/content/install-guides/kiro-cli.md b/content/install-guides/kiro-cli.md index e096852a62..f58e7a62ca 100644 --- a/content/install-guides/kiro-cli.md +++ b/content/install-guides/kiro-cli.md @@ -1,6 +1,6 @@ --- title: Kiro CLI -description: Install Kiro CLI on macOS or Arm Linux and verify authentication so you can use AWS-focused AI assistance from the command line. +description: Install and verify the Kiro CLI on macOS or Arm Linux so you can access AWS-focused AI assistance from the command line. author: Jason Andrews minutes_to_complete: 10 @@ -21,25 +21,27 @@ Kiro CLI is a command-line tool powered by a generative AI assistant. You can us It supports multiple operating systems, including Arm-based Linux distributions and macOS, and you can install it in several ways. -## What should I do before installing Kiro CLI? +## Before you begin You need a Builder ID to use Kiro CLI. If you don't have one, visit [Do more with AWS Builder ID](https://community.aws/builderid) and select **Sign up with Builder ID** to create your AWS Builder ID. -This guide explains how to install Kiro CLI on macOS and Arm Linux. +You'll learn how to install Kiro CLI on macOS and Arm Linux. -## How do I download and install Kiro CLI? +## How to download and install Kiro CLI -The CLI is invoked using the `kiro-cli` command. +You can invoke the CLI using the `kiro-cli` command. -The easiest way to install Kiro CLI on Linux and macOS is with a single command: +Install Kiro CLI on Linux and macOS with a single command: ```console curl -fsSL https://cli.kiro.dev/install | bash ``` -### Can I use Homebrew to install Kiro CLI on macOS? +### Install Kiro CLI on macOS using Homebrew -Yes, you can install [Homebrew](https://brew.sh/) if it's not already available on your computer. +You can also use [Homebrew](https://brew.sh/) to install Kiro CLI. + +Start by installing Homebrew if it's not already available on your computer. Install Kiro CLI using Homebrew: @@ -47,14 +49,14 @@ Install Kiro CLI using Homebrew: brew install kiro-cli ``` -### Can I install Kiro CLI on Arm Linux by downloading a ZIP file? +### Install Kiro CLI on Arm Linux by downloading a ZIP file -Yes, you can download and install Kiro CLI on any Arm Linux distribution using the installer. +You can download and install Kiro CLI on any Arm Linux distribution using the installer. Before starting, ensure that `curl` and `unzip` are available on your computer. {{% notice Note %}} -For Debian-based distributions such as Ubuntu, use the commands below. For other Linux distributions, use the appropriate package manager to install `curl` and `unzip`. +For Debian-based distributions such as Ubuntu, use the following commands. For other Linux distributions, use the appropriate package manager to install `curl` and `unzip`. {{% /notice %}} ```bash { target="ubuntu:latest" } @@ -75,7 +77,7 @@ unzip kirocli.zip bash ./kirocli/install.sh ``` -The installer prompts you about updating your shell configuration: +You'll be prompted by the installer about updating your shell configuration: ```output ✔ Do you want kiro to modify your shell config (you will have to manually do this otherwise)? @@ -86,7 +88,7 @@ To automate the install, add the `--no-confirm` flag to the `install.sh` command {{% notice Note %}} If you're using a Linux distribution with an older version of the GNU C Library, or one that doesn't use it at all (such as Alpine), you can download an alternative package. This package is built with the musl C library and has no external dependencies. -Substitute the `curl` command above with this one and use the same install instructions: +Substitute the `curl` command with this one and use the same install instructions: ```bash { target="ubuntu:latest" } curl --proto '=https' --tlsv1.2 -sSf 'https://desktop-release.q.us-east-1.amazonaws.com/latest/kirocli-aarch64-linux-musl.zip' -o 'kirocli.zip' @@ -94,7 +96,7 @@ curl --proto '=https' --tlsv1.2 -sSf 'https://desktop-release.q.us-east-1.amazon {{% /notice %}} -### How do I confirm Kiro CLI is working? +## Confirm Kiro CLI is working You now have the latest version of Kiro CLI installed. @@ -104,25 +106,25 @@ Confirm the CLI is available by printing the version: kiro-cli version ``` -The output shows the version: +The output shows the version, and is similar to: ```output kiro-cli 1.28.1 ``` -## How can I configure my AWS account to get the most from Kiro CLI? +## Configure your AWS account to get the most from Kiro CLI Kiro CLI can answer questions and solve problems related to your AWS resources and help you develop faster on AWS. To get the maximum benefit, you can configure the AWS CLI to use your account. -Follow the [AWS CLI Install Guide](/install-guides/aws-cli/) and the [AWS Credentials Install Guide](/install-guides/aws_access_keys/) to set up the AWS CLI and generate and configure access keys. +To set up the AWS CLI and generate and configure access keys, follow the [AWS CLI Install Guide](/install-guides/aws-cli/) and the [AWS Credentials Install Guide](/install-guides/aws_access_keys/). -This allows you to use Kiro CLI to ask questions and solve issues specific to your AWS account. +By setting up credentials, you can use the Kiro CLI to ask questions and solve issues specific to your AWS account. For example, you can ask for the IP address of an EC2 instance instead of going to the AWS console or looking up the AWS CLI command to get it. -Kiro accesses your AWS resources and prints the information you ask for. +Kiro accesses your AWS resources and returns the information you ask for. -## How can I set the Kiro CLI context to tailor responses? +## Set the Kiro CLI context to tailor responses Kiro CLI can read your context. If you provide more information about yourself, you get tailored responses that match your development environment. @@ -134,7 +136,7 @@ Use the `/context` command to see the possible locations to store your context. /context show ``` -The help information is printed. +The output is similar to: ```output @@ -149,7 +151,7 @@ Session (temporary) No files in the current directory matched the rules above. ``` -For example, you can create a new file to store your context as shown below: +For example, you can create a new file to store your context as follows: ```console echo "I am an Arm Linux developer. I prefer Ubuntu and other Debian based distributions. I don't use any x86 computers so please provide all information assuming I'm working on Arm Linux. Sometimes I use macOS and Windows on Arm, but please only provide information about these operating systems when I ask for it." > ~/.kiro/context.md @@ -163,13 +165,13 @@ Load the context file: /context add ~/.kiro/context.md ``` -Confirm it was read: +Confirm the context file was read: ```console did you read my context information? ``` -The response confirms the context file was read: +The response confirms the context file was read, and is similar to: ```output Yes, I read your context information. You're an Arm Linux developer who prefers Ubuntu and other Debian-based @@ -179,7 +181,7 @@ information about those when you specifically ask for them. Ask questions like "How do I install the AWS CLI?" to verify that the answers match the provided context. -## How do I change the model Kiro uses? +## Change the model Kiro uses When you start `kiro-cli chat`, the model is printed: @@ -193,7 +195,7 @@ Use the `/model` command to list other available models: /model ``` -The model options are displayed: +The output is similar to: ```output Press (↑↓) to navigate · Enter(⏎) to select model @@ -209,7 +211,7 @@ You can ask Kiro to set the default model for future sessions. ## Install a local MCP server -The Arm MCP Server is an MCP server providing AI assistants with tools and knowledge for Arm architecture development, migration, and optimization. This section shows how to configure the Arm MCP server locally using Docker. +The Arm MCP Server is an MCP server providing AI assistants with tools and knowledge for Arm architecture development, migration, and optimization. You can configure the Arm MCP server locally using Docker. First, pull the MCP server image to your local machine: @@ -217,13 +219,13 @@ First, pull the MCP server image to your local machine: docker pull armlimited/arm-mcp:latest ``` -You also need Docker running on the system. See the [Docker install guide](/install-guides/docker/) for instructions. +You also need Docker running on the system. For instructions, see the [Docker install guide](/install-guides/docker/). -### How do I configure the Arm MCP server? +### Configure the Arm MCP server for Kiro CLI Modify the file `~/.kiro/settings/mcp.json` to add the Arm MCP server via a Docker container. -To analyze a local codebase, use a `-v` command to mount a volume to the Arm MCP server `/workspace` folder so it can access code you want to analyze with migrate-ease and other tools. +To analyze a local codebase, use a `-v` command to mount a volume to the Arm MCP server `/workspace` folder so it can access code you want to analyze with `migrate-ease` and other tools. Replace the path `/path/to/your/workspace` with the path to your local codebase: @@ -256,7 +258,7 @@ To enable Arm Performix features through the Arm MCP Server, replace `/path/to/y ### Optional: Use a Docker replacement containerization tool -You can use other containerization tools besides Docker that are free and do not require licenses, such as Podman, Finch, Colima, and Rancher Desktop. Choose one of the options below and use its CLI in place of `docker`. +You can use other containerization tools besides Docker that are free and don't require licenses, such as Podman, Finch, Colima, and Rancher Desktop. Choose one of the following options and use its CLI in place of `docker`. {{< tabpane-normal >}} {{< tab header="Podman" >}} @@ -389,9 +391,9 @@ Add the following configuration to the user-level `~/.kiro/settings/mcp.json` fi {{< /tab >}} {{< /tabpane-normal >}} -### How do I verify the Arm MCP server is working? +### Verify that the Arm MCP server is working -Start Kiro CLI chat from your local shell and list the tools from the MCP server to verify it is working: +Start Kiro CLI chat from your local shell and list the tools from the MCP server to verify it's working: ```console kiro-cli chat @@ -403,9 +405,9 @@ Use the `/tools` command to list the available tools: /tools ``` -You should see the Arm MCP server tools listed in the output. If the arm-mcp server says it's still loading, wait a moment and run `/tools` again. +You'll see the Arm MCP server tools listed in the output. If the arm-mcp server says it's still loading, wait a moment and run `/tools` again. -### Use Arm prompt files with the MCP Server +### Use Arm prompt files with the Arm MCP Server The Arm MCP Server provides a rich set of tools and knowledge base, but to make the best use of it, you should pair it with Arm-specific prompt files. These prompt files supply task-oriented context, best practices, and structured workflows that guide the agent in using MCP tools more effectively across common Arm development tasks. @@ -419,4 +421,8 @@ Each prompt file is a Markdown configuration that you can reference in your Kiro If you're facing issues or have questions, reach out to mcpserver@arm.com. +## Next steps + You're now ready to use Kiro CLI with the Arm MCP server for Arm-specific development assistance. + +For an AI-assisted x86-to-Arm migration walkthrough, see [Automate x86-to-Arm application migration using the Arm MCP Server](/learning-paths/servers-and-cloud-computing/arm-mcp-server/). \ No newline at end of file From ff322d3bfbb5b11bdaab6f60c73d937b3ff5be35 Mon Sep 17 00:00:00 2001 From: anupras-mohapatra-arm Date: Tue, 30 Jun 2026 13:02:29 -0500 Subject: [PATCH 2/3] edit --- content/install-guides/kiro-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/install-guides/kiro-cli.md b/content/install-guides/kiro-cli.md index f58e7a62ca..648bf68b23 100644 --- a/content/install-guides/kiro-cli.md +++ b/content/install-guides/kiro-cli.md @@ -19,7 +19,7 @@ weight: 1 Kiro CLI is a command-line tool powered by a generative AI assistant. You can use it to ask questions about AWS architecture, resources, and general development tasks. -It supports multiple operating systems, including Arm-based Linux distributions and macOS, and you can install it in several ways. +You can install Kiro CLI in several ways on multiple operating systems, including Arm-based Linux distributions and macOS. ## Before you begin From 07caa8846e6a7e7a25d0f44efc41f33926079ba0 Mon Sep 17 00:00:00 2001 From: anupras-mohapatra-arm Date: Tue, 30 Jun 2026 15:55:57 -0500 Subject: [PATCH 3/3] edits --- content/install-guides/kiro-cli.md | 34 +++++++++++++----------------- 1 file changed, 15 insertions(+), 19 deletions(-) diff --git a/content/install-guides/kiro-cli.md b/content/install-guides/kiro-cli.md index 648bf68b23..eab73e42bc 100644 --- a/content/install-guides/kiro-cli.md +++ b/content/install-guides/kiro-cli.md @@ -114,15 +114,11 @@ kiro-cli 1.28.1 ## Configure your AWS account to get the most from Kiro CLI -Kiro CLI can answer questions and solve problems related to your AWS resources and help you develop faster on AWS. To get the maximum benefit, you can configure the AWS CLI to use your account. +Kiro CLI can answer questions and solve problems related to your AWS resources. For example, you can ask for the IP address of an EC2 instance instead of going to the AWS console or looking up the AWS CLI command to get it. Kiro CLI accesses your AWS resources and returns the information you ask for. -To set up the AWS CLI and generate and configure access keys, follow the [AWS CLI Install Guide](/install-guides/aws-cli/) and the [AWS Credentials Install Guide](/install-guides/aws_access_keys/). - -By setting up credentials, you can use the Kiro CLI to ask questions and solve issues specific to your AWS account. - -For example, you can ask for the IP address of an EC2 instance instead of going to the AWS console or looking up the AWS CLI command to get it. +To get account-specific answers, configure AWS CLI credentials. -Kiro accesses your AWS resources and returns the information you ask for. +To set up the AWS CLI and generate and configure access keys, follow the [AWS CLI Install Guide](/install-guides/aws-cli/) and the [AWS Credentials Install Guide](/install-guides/aws_access_keys/). ## Set the Kiro CLI context to tailor responses @@ -209,9 +205,11 @@ Use the arrow keys to select the model you want to use. You can ask Kiro to set the default model for future sessions. -## Install a local MCP server +## Configure the Arm MCP Server for Kiro CLI + +You can use a Model Context Protocol (MCP) such as the Arm MCP Server with Kiro CLI. -The Arm MCP Server is an MCP server providing AI assistants with tools and knowledge for Arm architecture development, migration, and optimization. You can configure the Arm MCP server locally using Docker. +The Arm MCP Server provides AI assistants with tools and knowledge for Arm architecture development, migration, and optimization. You can configure the Arm MCP Server locally using Docker. First, pull the MCP server image to your local machine: @@ -221,11 +219,9 @@ docker pull armlimited/arm-mcp:latest You also need Docker running on the system. For instructions, see the [Docker install guide](/install-guides/docker/). -### Configure the Arm MCP server for Kiro CLI - -Modify the file `~/.kiro/settings/mcp.json` to add the Arm MCP server via a Docker container. +Modify the file `~/.kiro/settings/mcp.json` to add the Arm MCP Server via a Docker container. -To analyze a local codebase, use a `-v` command to mount a volume to the Arm MCP server `/workspace` folder so it can access code you want to analyze with `migrate-ease` and other tools. +To analyze a local codebase, use a `-v` command to mount a volume to the Arm MCP Server `/workspace` folder so it can access code you want to analyze with `migrate-ease` and other tools. Replace the path `/path/to/your/workspace` with the path to your local codebase: @@ -256,9 +252,9 @@ Replace the path `/path/to/your/workspace` with the path to your local codebase: To enable Arm Performix features through the Arm MCP Server, replace `/path/to/your/ssh/private_key` and `/path/to/your/ssh/known_hosts` with the SSH private key and `known_hosts` file used for your target device. -### Optional: Use a Docker replacement containerization tool +### (Optional) Use an alternative containerization tool -You can use other containerization tools besides Docker that are free and don't require licenses, such as Podman, Finch, Colima, and Rancher Desktop. Choose one of the following options and use its CLI in place of `docker`. +You can use other containerization tools besides Docker that are free and don't require licenses, such as Podman, Finch, Colima, and Rancher Desktop. Choose one of the following options and use its CLI in place of `docker` to configure the Arm MCP Server. {{< tabpane-normal >}} {{< tab header="Podman" >}} @@ -359,7 +355,7 @@ Add the following configuration to the user-level `~/.kiro/settings/mcp.json` fi {{< tab header="Rancher Desktop" >}} Install: [Rancher Desktop](https://docs.rancherdesktop.io/getting-started/installation/) -Rancher Desktop uses the Docker container engine via Morby. +Rancher Desktop uses the Docker container engine via Moby. Pull the Arm MCP Server image: ```console @@ -391,7 +387,7 @@ Add the following configuration to the user-level `~/.kiro/settings/mcp.json` fi {{< /tab >}} {{< /tabpane-normal >}} -### Verify that the Arm MCP server is working +### Verify that the Arm MCP Server is working Start Kiro CLI chat from your local shell and list the tools from the MCP server to verify it's working: @@ -405,7 +401,7 @@ Use the `/tools` command to list the available tools: /tools ``` -You'll see the Arm MCP server tools listed in the output. If the arm-mcp server says it's still loading, wait a moment and run `/tools` again. +You'll see the Arm MCP Server tools listed in the output. If the `arm-mcp` server says it's still loading, wait a moment and run `/tools` again. ### Use Arm prompt files with the Arm MCP Server @@ -423,6 +419,6 @@ If you're facing issues or have questions, reach out to mcpserver@arm.com. ## Next steps -You're now ready to use Kiro CLI with the Arm MCP server for Arm-specific development assistance. +You're now ready to use Kiro CLI with the Arm MCP Server for Arm-specific development assistance. For an AI-assisted x86-to-Arm migration walkthrough, see [Automate x86-to-Arm application migration using the Arm MCP Server](/learning-paths/servers-and-cloud-computing/arm-mcp-server/). \ No newline at end of file