> ## 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 agent

> Start and stop the formae agent. Reference for formae agent and its subcommands.

Manage the [formae agent](/documentation/concepts/architecture), the long-running process
that reconciles your infrastructure and answers CLI requests.

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

### Examples

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

## formae agent start

Start the agent.

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

### Flags

| Flag               | Default | Description            |
| ------------------ | ------- | ---------------------- |
| `--config <path>`  |         | Path to a config file. |
| `--profile <name>` |         | Named profile to use.  |

## formae agent stop

Stop the agent.

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

This subcommand takes no flags beyond `--help`.