Set up Cursor Cloud dev environment

[rdasilveiracabral]

Summary

Sets up the development environment for the NOOA (NVIDIA OO Agents) framework in Cursor Cloud and documents non-obvious caveats for future agents.

Changes

• Adds a ## Cursor Cloud specific instructions section to AGENTS.md covering: uv install location, the need to sync all extras (not just the dev group) so MCP tests can collect, the default test invocation, the LLM API key requirement for generation methods/examples, and how to run the trace viewer.

Environment setup (not code)

• Update script (registered separately): python3 -m pip install --user --quiet --upgrade uv then python3 -m uv sync --all-extras --no-extra sandbox --group dev.

Verification

• uv run ruff check . → all checks passed; uv run ruff format --check . → 871 files already formatted.
• uv run pytest -m "not integration and not stress" → 6528 passed, 4 skipped.
• uv run nooa start-dev → trace viewer live on http://localhost:5001.
• Full LLM generation hello-world (with provider keys added): uv run python examples/quickstart/01_first_generation_method.py → real Nemotron NIM output; examples/quickstart/06_tracing.py → MathAgent ran LLM methods calculate()/explain() and the 15-event trace (incl. nvidia_nim/nemotron LLM spans) rendered in the viewer.
• Live-API path: uv run pytest -m integration tests/unifiedllm/test_responses_client.py -k "simple_completion or structured_output" → 4 passed.

nooa_llm_generation_trace_demo.mp4
LLM-backed span tree (run/calculate/explain with nemotron LLM spans)
Expanded LLM span showing prompt and generated tool call

Note: a bare uv run on a fresh VM creates .venv with default deps only (no mcp extra); re-run uv sync --all-extras --no-extra sandbox --group dev (the startup update script does this) to restore the full test env.

_{To show artifacts inline, enable in settings.}

  

[rdasilveiracabral]

Closing as stale.