> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formae.io/llms.txt
> Use this file to discover all available pages before exploring further.

# formae status

> Query the agent and past commands. Reference for formae status and its subcommands.

Retrieve status from the agent: its own health, and the history and progress of
commands you have run.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae status <agent|command> [flags]
```

### Examples

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae status agent
formae status command --query 'status:InProgress'
formae status command --query 'client:me'
```

## formae status agent

Receive the agent status.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae status agent [flags]
```

### Flags

| Flag                                 | Default | Description                                                 |
| ------------------------------------ | ------- | ----------------------------------------------------------- |
| `--watch`                            | `false` | Continuously refresh and print the status until completion. |
| `--output-consumer <human\|machine>` | `human` | Consumer of the command result.                             |
| `--output-schema <json\|yaml>`       | `json`  | The schema to use for the machine output.                   |
| `--config <path>`                    |         | Path to a config file.                                      |
| `--profile <name>`                   |         | Named profile to use.                                       |

## formae status command

Receive the status of previously executed commands.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae status command [flags]
```

### Examples

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae status command --query 'status:InProgress' --max-results 10
formae status command --query 'client:me command:apply'
formae status command --query 'stack:prod status:Success'
formae status command --watch
```

### Flags

| Flag                                  | Default   | Description                                                                  |
| ------------------------------------- | --------- | ---------------------------------------------------------------------------- |
| `--query <query>`                     |           | Find past and current commands by their attributes. `*` works as a wildcard. |
| `--max-results <int>`                 | `10`      | Maximum number of command results to return when using a query.              |
| `--output-layout <summary\|detailed>` | `summary` | What to print as status output.                                              |
| `--watch`                             | `false`   | Continuously refresh and print the status until completion.                  |
| `--output-consumer <human\|machine>`  | `human`   | Consumer of the command result.                                              |
| `--output-schema <json\|yaml>`        | `json`    | The schema to use for the machine output.                                    |
| `--config <path>`                     |           | Path to a config file.                                                       |
| `--profile <name>`                    |           | Named profile to use.                                                        |