tms-agent
v0.2.10
Published
Local agent for TMS Playwright automation — wakes on Run, opens Chrome on your machine, sleeps when idle
Maintainers
Readme
tms-agent
Local agent for Playwright test automation. Test code runs on the TMS server; Chrome runs on your machine.
Requires Node.js 18+ and Google Chrome.
Install (only step for testers)
npm install -g tms-agentThat is all. The installer:
- Starts the agent in the background on
127.0.0.1:9345 - Registers login autostart (macOS LaunchAgent / Linux systemd user service)
- Saves TMS server settings when you open Automation in the browser (no env vars)
How it connects
- Open Test → Automation in TMS in your browser
- The page opens a WebSocket to
ws://127.0.0.1:9345/ws - The browser sends your TMS server URL; the agent saves it to
~/.tms-agent/config.json - When you leave Automation, the WebSocket closes and Chrome closes if idle
Manual start (optional)
tms-agentEnvironment (optional overrides)
| Variable | Default |
|----------|---------|
| TMS_AGENT_PORT | 9345 |
| TMS_API_URL | Set by browser, or http://localhost:5000/api |
| TMS_TUNNEL_URL | Set by browser |
| TMS_ORIGIN_ALLOWLIST | Set by browser |
Publish
See tms-agent publish guide in the monorepo.
