Error codes · Agents

PULSE-AGENT-004 The agent did not start

What does this mean

Pulse started to launch the agent, but it did not work. The agent program was found - otherwise there would have been an error PULSE-AGENT-001 - but the launch failed for a reason that Pulse did not recognize.

Why does this happen

Pulse doesn't know the reason. It launches the agent as a separate program and communicates with it via the ACP protocol; if the connection is broken at the start, Pulse sees only the break itself. In “More details” - what the agent program answered, often ACP connection closed.

If the reason was given by Pulse itself, it is written on the card in the “why” line. For example, “The adapter does not offer manual permission mode”: Pulse checks the agent’s actions with its own rules, and this agent does not know how to ask for permission.

What to do

  1. Repeat: Send the message to the agent again and Pulse will restart it.
  2. It didn’t help - click “Open Agents”, select an agent and click “Check”. The card shows whether the agent is installed and whether you are logged in.
  3. There is no login or it is out of date - click “Login” (“Login again”), complete the login in the terminal and click “Check” again.
  4. Try another agent in the same task - it will become clear whether the problem is with the agent or with the task.

When to write to support

Write to us if the agent is installed, logged in, and the launch ends with this error again and again. Click “Send report” in the error card - a report form will open, where the code and details have already been entered, the secrets are hidden in them. Add which agent you launched and click “View and Send”: the window will show exactly what is left - check and click “Submit”. If the cloud is turned off, the button is called “View and save” - send the resulting file to us in any way.