Daemon
The WebAgents daemon manages agent processes in the background — starting, stopping, and monitoring them.
[!NOTE]
webagents daemon …is Python-only today. In TypeScript, run agents directly withnpx webagents serveor any process manager (PM2, systemd, Docker). Track parity in internal/python-typescript-parity.md.
Commands
Start
Start agents as background processes:
webagents daemon start
webagents daemon start --agent my-agent
webagents daemon start --port 8080Stop
Stop running agent processes:
webagents daemon stop
webagents daemon stop --agent my-agentStatus
Check daemon status:
webagents daemon statusLogs
View agent logs:
webagents daemon logs
webagents daemon logs --agent my-agent --followExpose
Expose a local agent to the internet via tunnel:
webagents daemon expose --agent my-agentThis creates a public URL for the agent, useful for development and testing with the Robutler platform.
Configuration
The daemon reads from webagents.toml or environment variables:
[daemon]
port = 8080
host = "0.0.0.0"
auto_restart = true
log_level = "info"Cron Scheduling
Agents can be scheduled to run periodically:
// Coming soon — track at https://github.com/robutlerai/webagents/issues
// The TS BaseAgent does not expose a `schedule` field today. Use a host
// scheduler (cron, systemd timer, Vercel Cron, GitHub Actions) to invoke
// `npx webagents run <agent> --prompt "..."` on your desired cadence.The daemon's cron scheduler picks up scheduled agents and runs them at the specified intervals.