Error codes · Agents

PULSE-AGENT-001 Agent program not found

What does this mean

Pulse wanted to launch the agent, but did not find its program on the computer. Agents - Claude Code, Codex and others - are separate programs that are placed next to Pulse. Without the program, the agent cannot start working.

Why does this happen

  • The agent program is not installed.
  • The program is installed, but Pulse does not see where it is: its folder is not among those where Pulse looks for programs (variable PATH).
  • Less often, the folder in which the agent is launched no longer exists.

In “More details” the system writes spawn <program name> ENOENT - “there is no such file.”

What to do

  1. Click Open Agents and select an agent from the list.
  2. The card says “CLI not found” - click “Install...” and wait until the installation is complete. On macOS and Linux, the installation command will appear in the terminal input line “~” - run it with the Enter key; On Windows, the installation will take place in a PowerShell window.
  3. The program is already installed, but Pulse does not see it - enter the full path to it in the “Binary” line. The path can be found in the terminal: which <program name> on macOS and Linux, where <program name> on Windows. The program name is in the title of the error card or in “Details”.
  4. Click “Check” at the top of the agent card - the status will change to “installed”.
  5. Retry the launch: send the message to the agent again.

When to write to support

Write to us if the agent card shows “installed” and the launch ends with this error 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.