status-queries

Query asynchronous ovrtx operation status via Python and C APIs.

201|25|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/ovrtx --skill status-queries
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: status-queries
Source: https://github.com/NVIDIA-Omniverse/ovrtx/tree/main/.agents/skills/status-queries
Command: npx skills add https://github.com/NVIDIA-Omniverse/ovrtx --skill status-queries

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Monitor and report the progress of asynchronous ovrtx operations to provide real-time feedback and status visibility during long-running tasks.

Core Features & Use Cases

  • Query operation status through Python's Operation.query_status() and C's ovrtx_query_op_status() to obtain progress, counters, and state.
  • Use during USD loading, shader cache warm-ups, attribute writes, or other staged tasks to present progress to users or drive UI elements.
  • Benefit: reduces wait times by providing insight into operation lifecycle and enabling proactive handling of stalled or long tasks.

Quick Start

Track an ongoing operation by querying its status at regular intervals and inspecting progress and counters.

Frequently Asked Questions about status-queries

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query the progress of asynchronous ovrtx operations in real time?

Query asynchronous ovrtx operation progress by calling Python's Operation.query_status() or C's ovrtx_query_op_status() to retrieve real-time status snapshots, progress counters, and current state during long-running tasks.

What is the best way to monitor USD loading or shader cache warm-up progress?

Monitor USD loading or shader cache warm-up progress by polling the ovrtx operation status at regular intervals, which provides visibility into the operation lifecycle and enables proactive handling of stalled or lengthy tasks.

Can I use ovrtx status queries to drive UI progress bars for staged attribute writes?

Yes, you can drive UI elements by querying ovrtx operation status during staged attribute writes, using the returned progress and counters to update progress bars and reflect real-time task completion states.

Does ovrtx operation status polling work with both Python and C/C++ workflows?

Ovrtx operation status polling works across both workflows, using Operation.query_status() in Python and ovrtx_query_op_status() with the operation index in C, followed by appropriate release calls to manage resources.

Why does my long-running ovrtx task stall without progress feedback?

Long-running ovrtx tasks lack progress feedback when status queries are not implemented, meaning you must actively poll the operation status to obtain progress counters and identify stalled or incomplete states.

How do I release resources after querying operation status in C?

Release resources in C after querying operation status by following the ovrtx_query_op_status() call with the appropriate release calls to ensure proper memory management during the asynchronous polling loop.