agent command
This command allows you to start or stop a formae agent.
Usage
formae agent [COMMAND]Commands
| Command | Description |
|---|---|
start |
Start the agent daemon |
stop |
Stop the agent daemon |
Starting the agent
Starting the agent comes with a set of options required for its correct operation.
Stopping the agent
Stopping doesn't require any additional parameters or options and is straightforward. When the agent is stopped, all unfinished forma commands will be postponed until the agent gets started again.
Important: Single Agent Per Target
Agents should never share targets.
A single target should only ever be managed by one formae agent.
This includes:
- Multiple localhost agents pointing to the same target
- Different team members running local agents that share targets
- Separate agent instances managing the same infrastructure
Why this matters:
formae does not support multi-agent setups. Running multiple agents that share targets will result in unpredictable behavior.
Multiple CLI clients connecting to one agent is expected and recommended.
The correct pattern is:
- One agent per target
- Multiple team members connect their CLI to that same agent
- All formae commands (apply, status, extract, etc.) go through the shared agent