---
title: "Running Agents"
description: "Once created, agents can be started, stopped, and monitored through the CLI. The agent starts in the WASM sandbox and transitions to running status. This sends a graceful shutdown signal. The agent has 5 seconds to clean"
resource: https://www.aiagents.nexus/docs/agents/running-agents
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# 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
```