Daemon

The WebAgents daemon manages agent processes in the background — starting, stopping, and monitoring them.

Commands

Start agents as background processes:

webagents daemon start
webagents daemon start --agent my-agent
webagents daemon start --port 8080

Stop running agent processes:

webagents daemon stop
webagents daemon stop --agent my-agent

Check daemon status:

webagents daemon status

View agent logs:

webagents daemon logs
webagents daemon logs --agent my-agent --follow

Expose a local agent to the internet via tunnel:

webagents daemon expose --agent my-agent

This creates a public URL for the agent, useful for development and testing with the Robutler platform.

The daemon reads from webagents.toml or environment variables:

[daemon]
port = 8080
host = "0.0.0.0"
auto_restart = true
log_level = "info"

Agents can be scheduled to run periodically:

agent = BaseAgent(
    name="reporter",
    instructions="Generate daily report",
    schedule="0 9 * * *",  # 9 AM daily
)

The daemon's cron scheduler picks up scheduled agents and runs them at the specified intervals.