# List stacks

List stacks within the given command path.

## Usage

```bash
tkm stacks list [command-path] [--output <format>]
```

## Positional arguments

* `command-path`
  * Command path to select which stacks to list.
  * Optional, by default, Takomo lists all stacks.

## Options

In addition to the [common options](/command-line-usage/common-options.md), this command has the following options.

* `--output <format>`
  * Print the command result using this format
  * Supported values: `text`, `json`, `yaml`

## IAM permissions

These are the minimum IAM permissions required to run this command.

```yaml
Statement: 
  - Sid: Stacks
    Effect: Allow
    Action: cloudformation:DescribeStacks
    Resource: "*"

  # IAM permissions needed only if command roles are used.  
  # Specify Resource to restrict access to specific roles.  
  - Sid: IAM
    Effect: Allow
    Action: sts:AssumeRole
    Resource: "*" 
```

## Examples

List all stacks:

```
tkm stacks list
```

List stacks within the given command path:

```
tkm stacks list /prod
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.takomo.io/command-line-usage/list-stacks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.