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

# formae status

> Query the agent and past commands. Reference for formae command status/list and formae agent status.

<Warning>
  `formae status` is deprecated. Use [`formae command`](/documentation/reference/cli/command)
  to check a command or browse history, and [`formae agent status`](/documentation/reference/cli/agent)
  for the agent's own health.

  `formae status agent` and `formae status command` still work as deprecated
  aliases for one release, but no longer appear in help output or shell
  completion, so update scripts rather than relying on them.

  | Old                     | New                                                                      |
  | ----------------------- | ------------------------------------------------------------------------ |
  | `formae status agent`   | `formae agent status`                                                    |
  | `formae status command` | `formae command status` (one command) or `formae command list` (history) |
</Warning>

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 command <status|list> [flags]
formae agent status [flags]
```

### Examples

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

## formae agent status

Receive the agent status.

```bash theme={"languages":{"custom":["/languages/pkl.json"]}}
formae agent status [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 command status

Receive the status of a single command. It takes an optional positional id
instead of a query; with no id it returns the most recently executed command.

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

### Examples

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

### Flags

| Flag                                  | Default   | Description                               |
| ------------------------------------- | --------- | ----------------------------------------- |
| `--output-layout <summary\|detailed>` | `summary` | What to print as status output.           |
| `--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 command status` does not take `--query` or `--max-results`; for a
query-driven, potentially multi-result view, use `formae command list`.

## formae command list

List previously executed commands.

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

### Examples

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

### Flags

| Flag                                  | Default   | Description                                                                  |
| ------------------------------------- | --------- | ---------------------------------------------------------------------------- |
| `--query <query>`                     |           | Find past and current commands by their attributes. `*` works as a wildcard. |
| `--max-results <int>`                 | `50`      | Maximum number of command results to return when using a query.              |
| `--output-layout <summary\|detailed>` | `summary` | What to print as status output.                                              |
| `--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.                                                        |