Running Agents

Once created, agents can be started, stopped, and monitored through the CLI.

Starting an Agent

bash

naos run my-agent

The agent starts in the WASM sandbox and transitions to running status.

Stopping an Agent

bash

naos stop my-agent

This sends a graceful shutdown signal. The agent has 5 seconds to clean up before being forcefully terminated.

Checking Status

View a single agent:

bash

naos status my-agent

View all agents:

bash

naos status

Output format:

AGENT       STATUS    UPTIME    MEMORY    COST
researcher  running   4h 12m    24MB      $2.40
analyzer    running   4h 12m    18MB      $1.10
planner     idle      -         -         $0.00

Running Multiple Agents

Start all agents defined in your config:

bash

naos run --all

Agent Logs

View agent output:

bash

naos logs my-agent
naos logs my-agent --follow    # stream live
naos logs my-agent --tail 50   # last 50 lines

Resource Limits

Set memory limits per agent in the config:

yaml

agents:
  researcher:
    source: ./agents/researcher.wasm
    execution:
      memoryLimit: 128MB
      timeoutSeconds: 300

Creating Agents

WASM Sandbox