Error codes · Agents

PULSE-AGENT-003 The agent login window did not open

What does this mean

You clicked "Login" on the agent, but Pulse was unable to open a terminal with the login command. You can log into the agent’s account without this window - manually, in any terminal.

Why does this happen

Logging into the agent is a command from its own program, and it is executed in the terminal: Pulse does not intercept keys, it only opens the command. Pulse does not always know why the terminal did not open. Known cases:

  • The setup wizard opens the system terminal. On macOS this is Terminal.app and requires the "Pulse wants to manage Terminal.app" permission. If it was once banned, the window will not open;
  • on Linux Pulse searches for a terminal in the list - x-terminal-emulator, gnome-terminal, konsole, xfce4-terminal, xterm - and, not finding one, writes a command on the card that he needs to execute himself;
  • the agent does not have a login command.

What to do

  1. Open a terminal—for example, the Pulse terminal panel: ⌘J on macOS, Ctrl+J on Windows and Linux.
  2. Execute the agent login command in it. It is signed in “Settings → Agents” (local model and GigaChat - “Settings → Models”), in the agent card, line “Login”. If Pulse named the command in the error card, take it from there.
  3. Complete the login: in the browser or using the code that the agent will show.
  4. Return to Pulse and click "Check".

On macOS, permission returns in “System Preferences → Privacy and Security → Automation”: turn on “Terminal” for Pulse.

When to write to support

Write to us if the login in the terminal is successful, but Pulse after “Check” still considers that there is no login. 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 entered into 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.