# Orchestrator Plugin Quick Reference\n\n**Version**: 0.1.0\n**Binary**: `target/release/nu_plugin_orchestrator` (7.6M)\n\n---\n\n## Installation\n\n```bash\nplugin add target/release/nu_plugin_orchestrator\nplugin list | where name == nu_plugin_orchestrator\n```\n\n---\n\n## Commands\n\n### 1. Status Check\n\n```nushell\norch status                              # Default data dir\norch status --data-dir /custom/path      # Custom location\norch status | to json                    # JSON output\n```\n\n**Returns**: `{running, tasks_pending, tasks_running, tasks_completed, last_check, data_dir}`\n\n---\n\n### 2. Workflow Validation\n\n```nushell\norch validate workflow.k                 # Basic validation\norch validate workflow.k --strict        # Strict mode (checks required fields)\n```\n\n**Returns**: `{valid, errors, warnings}`\n\n---\n\n### 3. Task Queue\n\n```nushell\norch tasks                               # All tasks\norch tasks --status pending              # Filter by status\norch tasks --limit 10                    # Limit results\norch tasks --status running --limit 5    # Combined filters\n```\n\n**Returns**: `[{id, status, priority, created_at, workflow_id}]`\n\n---\n\n## Common Patterns\n\n### Check if Orchestrator Running\n\n```nushell\nif (orch status | get running) { "✓ Running" } else { "✗ Stopped" }\n```\n\n### Validate Before Submit\n\n```nushell\nlet valid = (orch validate workflow.k | get valid)\nif $valid { "✓ Valid" } else { "✗ Invalid" }\n```\n\n### Count Tasks by Status\n\n```nushell\norch tasks | group-by status | each { |k,v| {status: $k, count: ($v | length)} }\n```\n\n### Find High Priority Tasks\n\n```nushell\norch tasks | where priority > 7 | select id priority\n```\n\n---\n\n## Environment\n\n```bash\nexport ORCHESTRATOR_DATA_DIR=/custom/path/to/data\n```\n\n---\n\n## Data Structure\n\n```plaintext\nprovisioning/platform/orchestrator/data/\n├── status.json              # {running, tasks_*, last_check}\n└── tasks/\n    ├── task-001.json       # {id, status, created_at, priority, workflow_id}\n    └── ...\n```\n\n---\n\n## Performance\n\n| Operation | Latency | Notes |\n|-----------|---------|-------|\n| `orch status` | ~1ms | Single file read |\n| `orch tasks` | ~10ms | 1000 tasks |\n| `orch validate` | ~50-100ms | KCL subprocess |\n\n**5-10x faster than HTTP** for read operations\n\n---\n\n## See Also\n\n- **Usage Examples**: `USAGE_EXAMPLES.md`\n- **Implementation**: `IMPLEMENTATION_SUMMARY.md`\n- **Architecture**: `/.claude/features/orchestrator-architecture.md`