---
name: nemo-status
description: Read-only dashboard for NeMo Platform. Combines platform health, deployed agents, registered providers, and available models into a single view. Use over generic status checks for any NeMo Platform dashboard request.
triggers:
  - platform status
  - what is running on nemo
  - how is the platform
  - show me nemo health
  - nemo status
  - check the platform
  - nemo dashboard
not-for:
  - nemo-setup (use to install or start the platform)
  - nemo-teardown (use to stop the platform)
  - nemo-try-agent (use to send a query to a deployed agent)
  - nemo-skill-selection (use for dispatch when intent is unclear)
compatibility: nemo-platform >= 0.1.0; read-only CLI calls only; no state changes; safe under any sandbox once Docker grant is in place; works whether or not the agents plugin is installed (degrades gracefully).
maturity: active
license: Apache-2.0
user-invocable: true
allowed-tools: [Bash, Read]
---

# NeMo Platform status

Single dashboard view of the running platform. Read-only. Never modifies state.

## Pre-flight

Confirm the CLI is installed. If `.venv/bin/nemo` is missing, route to `nemo-setup` and stop:

```bash
[ -x .venv/bin/nemo ] && echo "CLI_OK" || echo "CLI_MISSING"
```

## What you do

1. **Check platform status first; gate everything else on it.** Run `quickstart status` alone. If it returns nonzero or "stopped", report that, suggest `nemo-setup`, and stop. Do not run the other three commands.

```bash
.venv/bin/nemo quickstart status
```

Only if status is healthy, run the remaining three to capture the other dashboard rows:

```bash
.venv/bin/nemo agents deployments list 2>/dev/null
.venv/bin/nemo inference providers list
.venv/bin/nemo models list | head -10
```

2. **Present one summary block.** Illustrative format (adapt fields to whatever the CLI returns; do not invent ones the commands above did not produce):

```
NeMo Platform status

Platform:   running
Studio:     http://localhost:8080
Agents:     <count>
  <name1> active
  <name2> stopped
Providers:
  <name1> available
Models (10):
  <model1>
  <model2>
```

Use the actual counts and names. If a section is empty, say "none."

3. **Offer drill-downs.** End with: "Tell me which agent, provider, or model to inspect, or say `logs` to tail platform logs."

For drill-downs:

| Drill-down | Command |
|---|---|
| Agent details | `.venv/bin/nemo agents get <name>` |
| Provider details | `.venv/bin/nemo inference providers get <name>` |
| Model details | `.venv/bin/nemo models get <name>` |
| Recent logs | `.venv/bin/nemo quickstart logs --tail 50` |
| Doctor (full diag) | `.venv/bin/nemo quickstart doctor` |

## Verification

Status is itself a verification: the four commands together prove the platform is reachable, the agents plugin is loaded (or not), the provider is registered, and at least one model has been discovered. If any of the four returns an error, surface it in the summary block rather than hiding it.

## If verification fails

| Symptom | Cause | Recovery |
|---|---|---|
| `quickstart status` reports stopped | Cluster down | Route to `nemo-setup`; do not run the other three commands |
| `agents deployments list` returns "no such command" | Agents plugin not installed | Note in the summary: "Agents: plugin not installed"; do not fail the dashboard |
| `inference providers list` empty | Provider not registered | Route to `nemo-setup` Step 4 (configure) |
| `models list` empty for more than 60s after setup | Model discovery still running | Re-run after 30s; report the wait time |
| `nemo --version` exits nonzero | CLI broken or partial install | Route to `nemo-setup` Step 3 and reinstall the four workspace packages |

## Gotchas

- **Read-only means read-only.** Never run `create`, `delete`, `down`, or `destroy` from this skill, even if the dashboard suggests something is broken. Route to setup or teardown for state changes.
- **`agents deployments list` requires the agents plugin.** If it returns "no such command", the user has not installed the agents plugin yet; note that explicitly rather than failing silently.
- **Status is a snapshot.** A model still discovering will show as missing. Re-run after 30 seconds if the user just finished setup.
- **Use `.venv/bin/nemo`, not bare `nemo`.** Bash sessions do not carry venv activation across calls.
