# NWO Robotics CLI v2.0

Command-line interface for the NWO Robotics API - the production-grade Vision-Language-Action platform with intelligent model orchestration.

## Installation

```bash
pip install nwo-robotics
```

Or install from source:

```bash
git clone https://github.com/nwo-capital/nwo-cli.git
cd nwo-cli
pip install -e .
```

## Quick Start

```bash
# Authenticate
nwo auth login

# Send a command to a robot
nwo robot "pick up the red box"

# Preview model routing
nwo models route "read the label"

# Create a robot swarm
nwo swarm create "Warehouse Team" --strategy divide_and_conquer

# Send IoT-enhanced command
nwo iot send "water plants" --temp 25.5 --humidity 60
```

## Commands

### Authentication
- `nwo auth login` - Authenticate with API key
- `nwo auth logout` - Remove credentials
- `nwo auth status` - Check authentication status

### Robot Control
- `nwo robot send "<instruction>"` - Send command to robot
- `nwo robot health` - Check API health
- `nwo robot learn --task <type>` - Get learned parameters

### Model Management
- `nwo models list` - List configured AI models
- `nwo models route "<instruction>"` - Preview routing decision

### Swarm Management
- `nwo swarm create "<name>"` - Create robot swarm
- `nwo swarm add-agent <id> --swarm <id>` - Add agent to swarm

### IoT & Sensors
- `nwo iot send "<instruction>" --temp 25.5` - Send with sensor data
- `nwo iot sensors` - List supported sensors

### Task Planning
- `nwo tasks plan "<instruction>"` - Create task plan
- `nwo tasks progress <task_id>` - Subscribe to progress

### Learning System
- `nwo learning params --task pick_object` - Get learned parameters

### Safety
- `nwo safety enable --agent bot_001` - Enable real-time safety

### Templates
- `nwo templates create "<name>" --tasks '<json>'` - Create template
- `nwo templates example` - Show example template

## Environment Variables

- `NWO_API_KEY` - Your API key (alternative to config file)

## API Documentation

Full API documentation: https://nwo.capital/docs

Developer Dashboard: https://nwo.capital/webapp/api-key.php

## License

Apache 2.0
