Local agent setup

Requirements

• Node.js 20 or newer
• npm/npx available for the current user
• a local Playwright repository
• no administrator rights
• no npm install -g
• no sudo

Login and start

npx @xyva/agent login
npx @xyva/agent start --port 7900

The default listener is 127.0.0.1:7900, so it is not exposed to your LAN or the public internet. The portal checks the local health endpoint and opens an authenticated local bridge.

On the first connection attempt, Chrome asks whether xyva.ai may access devices on your local network. Allow this request so the portal can reach the agent on 127.0.0.1. This does not expose the agent to other computers on your LAN.

Do not paste the agent connection token into tickets, chat, or screenshots. Stop the process with Cmd+C on macOS or Ctrl+C on Windows/Linux.

Troubleshooting

• Not reachable: verify the terminal process and selected port.
• Browser blocks the connection: allow local network access for xyva.ai in the site settings.
• Authentication required: run npx @xyva/agent login again.
• Protocol mismatch: update the agent package and restart it.
• Browser missing: allow the agent setup action to install Playwright Chromium into the user cache.