[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-astronomer-airflow":3,"mdc-7u0h74-key":54,"related-repo-astronomer-airflow":4454,"related-org-astronomer-airflow":4547},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":24,"repoUrl":25,"updatedAt":26,"license":27,"forks":28,"topics":29,"repo":49,"sourceUrl":52,"mdContent":53},"airflow","manage and troubleshoot Airflow via CLI","Queries, manages, and troubleshoots Apache Airflow using the `af` CLI. Use when working with anything related to Airflow - a DAG, a DAG run, a task log, an import or parse error, a broken DAG, or any Airflow operation. Covers listing and triggering DAGs, retrying runs, reading task logs, diagnosing failures, debugging import and parse errors, checking connections, variables and pools, exploring the REST API, and monitoring health (for example \"trigger a pipeline\", \"retry a run\", \"list connections\", \"check Airflow health\", \"why did my DAG fail\"). This is the entrypoint that routes to sibling skills for authoring, testing, deploying, and migrating Airflow 2 to 3. Not for warehouse\u002FSQL analytics on Airflow metadata tables (use analyzing-data); for deep root-cause reports use debugging-dags or airflow-investigation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"astronomer","Astronomer","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fastronomer.png",[12,15,18,21],{"name":13,"slug":4,"type":14},"Airflow","tag",{"name":16,"slug":17,"type":14},"Data Pipeline","data-pipeline",{"name":19,"slug":20,"type":14},"CLI","cli",{"name":22,"slug":23,"type":14},"Debugging","debugging",412,"https:\u002F\u002Fgithub.com\u002Fastronomer\u002Fagents","2026-04-06T18:01:43.992997",null,55,[30,31,32,33,4,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48],"agentic-workflow","agents","ai","ai-agents","apache-airflow","claude","cursor","dag","data-engineering","data-pipelines","dbt","llm","mcp","orchestrator","skills","workflow-automation","workflow-management","workflow-orchestration","workflows",{"repoUrl":25,"stars":24,"forks":28,"topics":50,"description":51},[30,31,32,33,4,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48],"AI agent tooling for data engineering workflows.","https:\u002F\u002Fgithub.com\u002Fastronomer\u002Fagents\u002Ftree\u002FHEAD\u002Fskills\u002Fairflow","---\nname: airflow\ndescription: Queries, manages, and troubleshoots Apache Airflow using the `af` CLI. Use when working with anything related to Airflow - a DAG, a DAG run, a task log, an import or parse error, a broken DAG, or any Airflow operation. Covers listing and triggering DAGs, retrying runs, reading task logs, diagnosing failures, debugging import and parse errors, checking connections, variables and pools, exploring the REST API, and monitoring health (for example \"trigger a pipeline\", \"retry a run\", \"list connections\", \"check Airflow health\", \"why did my DAG fail\"). This is the entrypoint that routes to sibling skills for authoring, testing, deploying, and migrating Airflow 2 to 3. Not for warehouse\u002FSQL analytics on Airflow metadata tables (use analyzing-data); for deep root-cause reports use debugging-dags or airflow-investigation.\n---\n\n# Airflow Operations\n\nUse `af` commands to query, manage, and troubleshoot Airflow workflows.\n\n## Astro CLI\n\nThe [Astro CLI](https:\u002F\u002Fwww.astronomer.io\u002Fdocs\u002Fastro\u002Fcli\u002Foverview) is the recommended way to run Airflow locally and deploy to production. It provides a containerized Airflow environment that works out of the box:\n\n```bash\n# Initialize a new project\nastro dev init\n\n# Start local Airflow (webserver at http:\u002F\u002Flocalhost:8080)\nastro dev start\n\n# Parse DAGs to catch errors quickly (no need to start Airflow)\nastro dev parse\n\n# Run pytest against your DAGs\nastro dev pytest\n\n# Deploy to production\nastro deploy            # Full deploy (image + DAGs)\nastro deploy --dags     # DAG-only deploy (fast, no image build)\n```\n\nFor more details:\n- **New project?** See the **setting-up-astro-project** skill\n- **Local environment?** See the **managing-astro-local-env** skill\n- **Deploying?** See the **deploying-airflow** skill\n\n---\n\n## Running the CLI\n\nThese commands assume `af` is on PATH. Run via `astro otto` to get it automatically, or install standalone with `uv tool install astro-airflow-mcp`.\n\n## Instance Configuration\n\nManage multiple Airflow instances with persistent configuration:\n\n```bash\n# Add a new instance\naf instance add prod --url https:\u002F\u002Fairflow.example.com --token \"$API_TOKEN\"\naf instance add staging --url https:\u002F\u002Fstaging.example.com --username admin --password admin\n\n# List and switch instances\naf instance list      # Shows all instances in a table\naf instance use prod  # Switch to prod instance\naf instance current   # Show current instance\naf instance delete old-instance\n\n# Auto-discover instances (use --dry-run to preview first)\naf instance discover --dry-run        # Preview all discoverable instances\naf instance discover                  # Discover from all backends (astro, local)\naf instance discover astro            # Discover Astro deployments only\naf instance discover astro --all-workspaces  # Include all accessible workspaces\naf instance discover local            # Scan common local Airflow ports\naf instance discover local --scan     # Deep scan all ports 1024-65535\n\n# IMPORTANT: Always run with --dry-run first and ask for user consent before\n# running discover without it. The non-dry-run mode creates API tokens in\n# Astro Cloud, which is a sensitive action that requires explicit approval.\n\n# Show where an instance came from (file path + scope)\naf instance show prod\n\n# Override instance for a single command via env vars\nAIRFLOW_API_URL=https:\u002F\u002Fstaging.example.com AIRFLOW_AUTH_TOKEN=$STG af dags list\n\n# Or switch persistently\naf instance use staging\n```\n\nConfig layout (mirrors `git config` system\u002Fglobal\u002Flocal):\n\n| Scope | File | Committed? |\n|---|---|---|\n| Global | `~\u002F.astro\u002Fconfig.yaml` | n\u002Fa (per-user) |\n| Project shared | `\u003Croot>\u002F.astro\u002Fconfig.yaml` | yes |\n| Project local | `\u003Croot>\u002F.astro\u002Fconfig.local.yaml` | no (gitignored) |\n\n`\u003Croot>` is found by walking up from cwd looking for `.astro\u002F`. Default write routing inside a project: `add`\u002F`discover` → project-shared, `use` → project-local. Override with `--global` \u002F `--project` \u002F `--local`. Set `AF_CONFIG=\u003Cpath>` to bypass layering and use a single file.\n\nMigrate from the legacy `~\u002F.af\u002Fconfig.yaml` with `af migrate` (idempotent; renames the old file to `.bak`).\n\nTokens in config can reference environment variables using `${VAR}` syntax:\n```yaml\ninstances:\n- name: prod\n  url: https:\u002F\u002Fairflow.example.com\n  auth:\n    token: ${AIRFLOW_API_TOKEN}\n```\n\nOr use environment variables directly (no config file needed):\n\n```bash\nexport AIRFLOW_API_URL=http:\u002F\u002Flocalhost:8080\nexport AIRFLOW_AUTH_TOKEN=your-token-here\n# Or username\u002Fpassword:\nexport AIRFLOW_USERNAME=admin\nexport AIRFLOW_PASSWORD=admin\n```\n\nOr CLI flags: `af --airflow-url http:\u002F\u002Flocalhost:8080 --token \"$TOKEN\" \u003Ccommand>`\n\n## Quick Reference\n\n| Command | Description |\n|---------|-------------|\n| `af health` | System health check |\n| `af dags list` | List all DAGs |\n| `af dags get \u003Cdag_id>` | Get DAG details |\n| `af dags explore \u003Cdag_id>` | Full DAG investigation |\n| `af dags source \u003Cdag_id>` | Get DAG source code |\n| `af dags pause \u003Cdag_id>` | Pause DAG scheduling |\n| `af dags unpause \u003Cdag_id>` | Resume DAG scheduling |\n| `af dags errors` | List import errors |\n| `af dags warnings` | List DAG warnings |\n| `af dags stats` | DAG run statistics |\n| `af runs list` | List DAG runs |\n| `af runs get \u003Cdag_id> \u003Crun_id>` | Get run details |\n| `af runs trigger \u003Cdag_id>` | Trigger a DAG run |\n| `af runs trigger-wait \u003Cdag_id>` | Trigger and wait for completion |\n| `af runs delete \u003Cdag_id> \u003Crun_id>` | Permanently delete a DAG run |\n| `af runs clear \u003Cdag_id> \u003Crun_id>` | Clear a run for re-execution |\n| `af runs diagnose \u003Cdag_id> \u003Crun_id>` | Diagnose failed run |\n| `af tasks list \u003Cdag_id>` | List tasks in DAG |\n| `af tasks get \u003Cdag_id> \u003Ctask_id>` | Get task definition |\n| `af tasks instance \u003Cdag_id> \u003Crun_id> \u003Ctask_id>` | Get task instance |\n| `af tasks logs \u003Cdag_id> \u003Crun_id> \u003Ctask_id>` | Get task logs |\n| `af config version` | Airflow version |\n| `af config show` | Full configuration |\n| `af config connections` | List connections |\n| `af config variables` | List variables |\n| `af config variable \u003Ckey>` | Get specific variable |\n| `af config pools` | List pools |\n| `af config pool \u003Cname>` | Get pool details |\n| `af config plugins` | List plugins |\n| `af config providers` | List providers |\n| `af config assets` | List assets\u002Fdatasets |\n| `af api \u003Cendpoint>` | Direct REST API access |\n| `af api ls` | List available API endpoints |\n| `af api ls --filter X` | List endpoints matching pattern |\n| `af registry providers` | List providers in the Airflow Registry |\n| `af registry modules \u003Cprovider>` | List operators\u002Fhooks\u002Fsensors\u002Ftransfers in a provider |\n| `af registry parameters \u003Cprovider>` | Constructor signatures (name, type, default, required) for a provider's classes |\n| `af registry connections \u003Cprovider>` | Connection types a provider exposes |\n\n## User Intent Patterns\n\n### Getting Started\n- \"How do I run Airflow locally?\" \u002F \"Set up Airflow\" -> use the **managing-astro-local-env** skill (uses Astro CLI)\n- \"Create a new Airflow project\" \u002F \"Initialize project\" -> use the **setting-up-astro-project** skill (uses Astro CLI)\n- \"How do I install Airflow?\" \u002F \"Get started with Airflow\" -> use the **setting-up-astro-project** skill\n\n### DAG Operations\n- \"What DAGs exist?\" \u002F \"List all DAGs\" -> `af dags list`\n- \"Tell me about DAG X\" \u002F \"What is DAG Y?\" -> `af dags explore \u003Cdag_id>`\n- \"What's the schedule for DAG X?\" -> `af dags get \u003Cdag_id>`\n- \"Show me the code for DAG X\" -> `af dags source \u003Cdag_id>`\n- \"Stop DAG X\" \u002F \"Pause this workflow\" -> `af dags pause \u003Cdag_id>`\n- \"Resume DAG X\" -> `af dags unpause \u003Cdag_id>`\n- \"Are there any DAG errors?\" -> `af dags errors`\n- \"Create a new DAG\" \u002F \"Write a pipeline\" -> use the **authoring-dags** skill\n\n### Run Operations\n- \"What runs have executed?\" -> `af runs list`\n- \"Run DAG X\" \u002F \"Trigger the pipeline\" -> `af runs trigger \u003Cdag_id>`\n- \"Run DAG X and wait\" -> `af runs trigger-wait \u003Cdag_id>`\n- \"Why did this run fail?\" -> `af runs diagnose \u003Cdag_id> \u003Crun_id>`\n- \"Delete this run\" \u002F \"Remove stuck run\" -> `af runs delete \u003Cdag_id> \u003Crun_id>`\n- \"Clear this run\" \u002F \"Retry this run\" \u002F \"Re-run this\" -> `af runs clear \u003Cdag_id> \u003Crun_id>`\n- \"Test this DAG and fix if it fails\" -> use the **testing-dags** skill\n\n### Task Operations\n- \"What tasks are in DAG X?\" -> `af tasks list \u003Cdag_id>`\n- \"Get task logs\" \u002F \"Why did task fail?\" -> `af tasks logs \u003Cdag_id> \u003Crun_id> \u003Ctask_id>`\n- \"Full root cause analysis\" \u002F \"Diagnose and fix\" -> use the **debugging-dags** skill\n\n### Data Operations\n- \"Is the data fresh?\" \u002F \"When was this table last updated?\" -> use the **checking-freshness** skill\n- \"Where does this data come from?\" -> use the **tracing-upstream-lineage** skill\n- \"What depends on this table?\" \u002F \"What breaks if I change this?\" -> use the **tracing-downstream-lineage** skill\n\n### Deployment Operations\n- \"Deploy my DAGs\" \u002F \"Push to production\" -> use the **deploying-airflow** skill\n- \"Set up CI\u002FCD\" \u002F \"Automate deploys\" -> use the **deploying-airflow** skill\n- \"Deploy to Kubernetes\" \u002F \"Set up Helm\" -> use the **deploying-airflow** skill\n- \"astro deploy\" \u002F \"DAG-only deploy\" -> use the **deploying-airflow** skill\n\n### System Operations\n- \"What version of Airflow?\" -> `af config version`\n- \"What connections exist?\" -> `af config connections`\n- \"Are pools full?\" -> `af config pools`\n- \"Is Airflow healthy?\" -> `af health`\n\n### API Exploration\n- \"What API endpoints are available?\" -> `af api ls`\n- \"Find variable endpoints\" -> `af api ls --filter variable`\n- \"Access XCom values\" \u002F \"Get XCom\" -> `af api xcom-entries -F dag_id=X -F task_id=Y`\n- \"Get event logs\" \u002F \"Audit trail\" -> `af api event-logs -F dag_id=X`\n- \"Create connection via API\" -> `af api connections -X POST --body '{...}'`\n- \"Create variable via API\" -> `af api variables -X POST -F key=name -f value=val`\n\n### Registry Discovery\n- \"What operators does provider X have?\" -> `af registry modules \u003Cprovider>`\n- \"What are the constructor params for operator Y?\" -> `af registry parameters \u003Cprovider>`\n- \"What providers exist?\" \u002F \"Is there a provider for Z?\" -> `af registry providers`\n- \"What connection types does provider X expose?\" -> `af registry connections \u003Cprovider>`\n- \"Writing a DAG with a specific operator\" -> use registry to verify current signature before copying examples\n\n## Common Workflows\n\n### Validate DAGs Before Deploying\n\nIf you're using the Astro CLI, you can validate DAGs without a running Airflow instance:\n\n```bash\n# Parse DAGs to catch import errors and syntax issues\nastro dev parse\n\n# Run unit tests\nastro dev pytest\n```\n\nOtherwise, validate against a running instance:\n\n```bash\naf dags errors     # Check for parse\u002Fimport errors\naf dags warnings   # Check for deprecation warnings\n```\n\n### Discover Operator Signatures Before Writing Code\n\nThe Airflow Registry at `airflow.apache.org\u002Fregistry` is the authoritative source for provider classes and their current constructor signatures. Prefer it over memory or stale documentation when authoring DAGs — the registry reflects the live provider release.\n\n```bash\n# List all providers and pick the one you need\naf registry providers | jq '.providers[] | {id, name, version}'\n\n# List every operator \u002F hook \u002F sensor in a provider (e.g. standard, amazon, google)\naf registry modules standard \\\n  | jq '.modules[] | {name, type, import_path, docs_url}'\n\n# Get the current constructor signature for a specific class\naf registry parameters standard \\\n  | jq '.classes[\"airflow.providers.standard.operators.hitl.ApprovalOperator\"].parameters'\n\n# Filter modules by substring (useful when you know the concept but not the class)\naf registry modules standard \\\n  | jq '.modules[] | select(.import_path | test(\"hitl\"))'\n```\n\nResults are cached locally: 1 hour for the latest version, 30 days for pinned versions (which are immutable). Add `--version X.Y.Z` to any `modules` \u002F `parameters` \u002F `connections` call to target a specific release.\n\n### Investigate a Failed Run\n\n```bash\n# 1. List recent runs to find failure\naf runs list --dag-id my_dag\n\n# 2. Diagnose the specific run\naf runs diagnose my_dag manual__2024-01-15T10:00:00+00:00\n\n# 3. Get logs for failed task (from diagnose output)\naf tasks logs my_dag manual__2024-01-15T10:00:00+00:00 extract_data\n\n# 4. After fixing, clear the run to retry all tasks\naf runs clear my_dag manual__2024-01-15T10:00:00+00:00\n```\n\n### Morning Health Check\n\n```bash\n# 1. Overall system health\naf health\n\n# 2. Check for broken DAGs\naf dags errors\n\n# 3. Check pool utilization\naf config pools\n```\n\n### Understand a DAG\n\n```bash\n# Get comprehensive overview (metadata + tasks + source)\naf dags explore my_dag\n```\n\n### Check Why DAG Isn't Running\n\n```bash\n# Check if paused\naf dags get my_dag\n\n# Check for import errors\naf dags errors\n\n# Check recent runs\naf runs list --dag-id my_dag\n```\n\n### Trigger and Monitor\n\n```bash\n# Option 1: Trigger and wait (blocking)\naf runs trigger-wait my_dag --timeout 1800\n\n# Option 2: Trigger and check later\naf runs trigger my_dag\naf runs get my_dag \u003Crun_id>\n```\n\n## Output Format\n\nAll commands output JSON (except `instance` commands which use human-readable tables):\n\n```bash\naf dags list\n# {\n#   \"total_dags\": 5,\n#   \"returned_count\": 5,\n#   \"dags\": [...]\n# }\n```\n\nUse `jq` for filtering:\n\n```bash\n# Find failed runs\naf runs list | jq '.dag_runs[] | select(.state == \"failed\")'\n\n# Get DAG IDs only\naf dags list | jq '.dags[].dag_id'\n\n# Find paused DAGs\naf dags list | jq '[.dags[] | select(.is_paused == true)]'\n```\n\n## Task Logs Options\n\n```bash\n# Get logs for specific retry attempt\naf tasks logs my_dag run_id task_id --try 2\n\n# Get logs for mapped task index\naf tasks logs my_dag run_id task_id --map-index 5\n```\n\n## Direct API Access with `af api`\n\nUse `af api` for endpoints not covered by high-level commands (XCom, event-logs, backfills, etc).\n\n```bash\n# Discover available endpoints\naf api ls\naf api ls --filter variable\n\n# Basic usage\naf api dags\naf api dags -F limit=10 -F only_active=true\naf api variables -X POST -F key=my_var -f value=\"my value\"\naf api variables\u002Fold_var -X DELETE\n```\n\n**Field syntax**: `-F key=value` auto-converts types, `-f key=value` keeps as string.\n\n**Full reference**: See [api-reference.md](api-reference.md) for all options, common endpoints (XCom, event-logs, backfills), and examples.\n\n## Related Skills\n\n| Skill | Use when... |\n|-------|-------------|\n| **authoring-dags** | Creating or editing DAG files with best practices |\n| **testing-dags** | Iterative test -> debug -> fix -> retest cycles |\n| **debugging-dags** | Deep root cause analysis and failure diagnosis |\n| **checking-freshness** | Checking if data is up to date or stale |\n| **tracing-upstream-lineage** | Finding where data comes from |\n| **tracing-downstream-lineage** | Impact analysis -- what breaks if something changes |\n| **deploying-airflow** | Deploying DAGs to production (Astro, Docker Compose, Kubernetes) |\n| **migrating-airflow-2-to-3** | Upgrading DAGs from Airflow 2.x to 3.x |\n| **managing-astro-local-env** | Starting, stopping, or troubleshooting local Airflow |\n| **setting-up-astro-project** | Initializing a new Astro\u002FAirflow project |\n| **airflow-state-store** | Per-task checkpointing, watermarks, crash-safe operators (Airflow 3.3+) |\n| **airflow-hitl** | Pausing a DAG for human approval or input (Airflow 3.1+) |\n",{"data":55,"body":56},{"name":4,"description":6},{"type":57,"children":58},"root",[59,68,83,90,105,310,315,368,372,378,406,412,417,985,998,1097,1171,1200,1213,1304,1309,1408,1419,1425,2093,2099,2106,2140,2146,2230,2236,2310,2316,2350,2356,2392,2398,2441,2447,2490,2496,2564,2570,2618,2624,2630,2635,2695,2700,2749,2755,2768,3016,3051,3057,3224,3230,3320,3326,3361,3367,3470,3476,3596,3602,3615,3677,3689,3842,3848,3954,3966,3977,4194,4220,4237,4243,4448],{"type":60,"tag":61,"props":62,"children":64},"element","h1",{"id":63},"airflow-operations",[65],{"type":66,"value":67},"text","Airflow Operations",{"type":60,"tag":69,"props":70,"children":71},"p",{},[72,74,81],{"type":66,"value":73},"Use ",{"type":60,"tag":75,"props":76,"children":78},"code",{"className":77},[],[79],{"type":66,"value":80},"af",{"type":66,"value":82}," commands to query, manage, and troubleshoot Airflow workflows.",{"type":60,"tag":84,"props":85,"children":87},"h2",{"id":86},"astro-cli",[88],{"type":66,"value":89},"Astro CLI",{"type":60,"tag":69,"props":91,"children":92},{},[93,95,103],{"type":66,"value":94},"The ",{"type":60,"tag":96,"props":97,"children":101},"a",{"href":98,"rel":99},"https:\u002F\u002Fwww.astronomer.io\u002Fdocs\u002Fastro\u002Fcli\u002Foverview",[100],"nofollow",[102],{"type":66,"value":89},{"type":66,"value":104}," is the recommended way to run Airflow locally and deploy to production. It provides a containerized Airflow environment that works out of the box:",{"type":60,"tag":106,"props":107,"children":112},"pre",{"className":108,"code":109,"language":110,"meta":111,"style":111},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","# Initialize a new project\nastro dev init\n\n# Start local Airflow (webserver at http:\u002F\u002Flocalhost:8080)\nastro dev start\n\n# Parse DAGs to catch errors quickly (no need to start Airflow)\nastro dev parse\n\n# Run pytest against your DAGs\nastro dev pytest\n\n# Deploy to production\nastro deploy            # Full deploy (image + DAGs)\nastro deploy --dags     # DAG-only deploy (fast, no image build)\n","bash","",[113],{"type":60,"tag":75,"props":114,"children":115},{"__ignoreMap":111},[116,128,149,159,168,185,193,202,219,227,236,253,261,270,288],{"type":60,"tag":117,"props":118,"children":121},"span",{"class":119,"line":120},"line",1,[122],{"type":60,"tag":117,"props":123,"children":125},{"style":124},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[126],{"type":66,"value":127},"# Initialize a new project\n",{"type":60,"tag":117,"props":129,"children":131},{"class":119,"line":130},2,[132,138,144],{"type":60,"tag":117,"props":133,"children":135},{"style":134},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[136],{"type":66,"value":137},"astro",{"type":60,"tag":117,"props":139,"children":141},{"style":140},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[142],{"type":66,"value":143}," dev",{"type":60,"tag":117,"props":145,"children":146},{"style":140},[147],{"type":66,"value":148}," init\n",{"type":60,"tag":117,"props":150,"children":152},{"class":119,"line":151},3,[153],{"type":60,"tag":117,"props":154,"children":156},{"emptyLinePlaceholder":155},true,[157],{"type":66,"value":158},"\n",{"type":60,"tag":117,"props":160,"children":162},{"class":119,"line":161},4,[163],{"type":60,"tag":117,"props":164,"children":165},{"style":124},[166],{"type":66,"value":167},"# Start local Airflow (webserver at http:\u002F\u002Flocalhost:8080)\n",{"type":60,"tag":117,"props":169,"children":171},{"class":119,"line":170},5,[172,176,180],{"type":60,"tag":117,"props":173,"children":174},{"style":134},[175],{"type":66,"value":137},{"type":60,"tag":117,"props":177,"children":178},{"style":140},[179],{"type":66,"value":143},{"type":60,"tag":117,"props":181,"children":182},{"style":140},[183],{"type":66,"value":184}," start\n",{"type":60,"tag":117,"props":186,"children":188},{"class":119,"line":187},6,[189],{"type":60,"tag":117,"props":190,"children":191},{"emptyLinePlaceholder":155},[192],{"type":66,"value":158},{"type":60,"tag":117,"props":194,"children":196},{"class":119,"line":195},7,[197],{"type":60,"tag":117,"props":198,"children":199},{"style":124},[200],{"type":66,"value":201},"# Parse DAGs to catch errors quickly (no need to start Airflow)\n",{"type":60,"tag":117,"props":203,"children":205},{"class":119,"line":204},8,[206,210,214],{"type":60,"tag":117,"props":207,"children":208},{"style":134},[209],{"type":66,"value":137},{"type":60,"tag":117,"props":211,"children":212},{"style":140},[213],{"type":66,"value":143},{"type":60,"tag":117,"props":215,"children":216},{"style":140},[217],{"type":66,"value":218}," parse\n",{"type":60,"tag":117,"props":220,"children":222},{"class":119,"line":221},9,[223],{"type":60,"tag":117,"props":224,"children":225},{"emptyLinePlaceholder":155},[226],{"type":66,"value":158},{"type":60,"tag":117,"props":228,"children":230},{"class":119,"line":229},10,[231],{"type":60,"tag":117,"props":232,"children":233},{"style":124},[234],{"type":66,"value":235},"# Run pytest against your DAGs\n",{"type":60,"tag":117,"props":237,"children":239},{"class":119,"line":238},11,[240,244,248],{"type":60,"tag":117,"props":241,"children":242},{"style":134},[243],{"type":66,"value":137},{"type":60,"tag":117,"props":245,"children":246},{"style":140},[247],{"type":66,"value":143},{"type":60,"tag":117,"props":249,"children":250},{"style":140},[251],{"type":66,"value":252}," pytest\n",{"type":60,"tag":117,"props":254,"children":256},{"class":119,"line":255},12,[257],{"type":60,"tag":117,"props":258,"children":259},{"emptyLinePlaceholder":155},[260],{"type":66,"value":158},{"type":60,"tag":117,"props":262,"children":264},{"class":119,"line":263},13,[265],{"type":60,"tag":117,"props":266,"children":267},{"style":124},[268],{"type":66,"value":269},"# Deploy to production\n",{"type":60,"tag":117,"props":271,"children":273},{"class":119,"line":272},14,[274,278,283],{"type":60,"tag":117,"props":275,"children":276},{"style":134},[277],{"type":66,"value":137},{"type":60,"tag":117,"props":279,"children":280},{"style":140},[281],{"type":66,"value":282}," deploy",{"type":60,"tag":117,"props":284,"children":285},{"style":124},[286],{"type":66,"value":287},"            # Full deploy (image + DAGs)\n",{"type":60,"tag":117,"props":289,"children":291},{"class":119,"line":290},15,[292,296,300,305],{"type":60,"tag":117,"props":293,"children":294},{"style":134},[295],{"type":66,"value":137},{"type":60,"tag":117,"props":297,"children":298},{"style":140},[299],{"type":66,"value":282},{"type":60,"tag":117,"props":301,"children":302},{"style":140},[303],{"type":66,"value":304}," --dags",{"type":60,"tag":117,"props":306,"children":307},{"style":124},[308],{"type":66,"value":309},"     # DAG-only deploy (fast, no image build)\n",{"type":60,"tag":69,"props":311,"children":312},{},[313],{"type":66,"value":314},"For more details:",{"type":60,"tag":316,"props":317,"children":318},"ul",{},[319,338,353],{"type":60,"tag":320,"props":321,"children":322},"li",{},[323,329,331,336],{"type":60,"tag":324,"props":325,"children":326},"strong",{},[327],{"type":66,"value":328},"New project?",{"type":66,"value":330}," See the ",{"type":60,"tag":324,"props":332,"children":333},{},[334],{"type":66,"value":335},"setting-up-astro-project",{"type":66,"value":337}," skill",{"type":60,"tag":320,"props":339,"children":340},{},[341,346,347,352],{"type":60,"tag":324,"props":342,"children":343},{},[344],{"type":66,"value":345},"Local environment?",{"type":66,"value":330},{"type":60,"tag":324,"props":348,"children":349},{},[350],{"type":66,"value":351},"managing-astro-local-env",{"type":66,"value":337},{"type":60,"tag":320,"props":354,"children":355},{},[356,361,362,367],{"type":60,"tag":324,"props":357,"children":358},{},[359],{"type":66,"value":360},"Deploying?",{"type":66,"value":330},{"type":60,"tag":324,"props":363,"children":364},{},[365],{"type":66,"value":366},"deploying-airflow",{"type":66,"value":337},{"type":60,"tag":369,"props":370,"children":371},"hr",{},[],{"type":60,"tag":84,"props":373,"children":375},{"id":374},"running-the-cli",[376],{"type":66,"value":377},"Running the CLI",{"type":60,"tag":69,"props":379,"children":380},{},[381,383,388,390,396,398,404],{"type":66,"value":382},"These commands assume ",{"type":60,"tag":75,"props":384,"children":386},{"className":385},[],[387],{"type":66,"value":80},{"type":66,"value":389}," is on PATH. Run via ",{"type":60,"tag":75,"props":391,"children":393},{"className":392},[],[394],{"type":66,"value":395},"astro otto",{"type":66,"value":397}," to get it automatically, or install standalone with ",{"type":60,"tag":75,"props":399,"children":401},{"className":400},[],[402],{"type":66,"value":403},"uv tool install astro-airflow-mcp",{"type":66,"value":405},".",{"type":60,"tag":84,"props":407,"children":409},{"id":408},"instance-configuration",[410],{"type":66,"value":411},"Instance Configuration",{"type":60,"tag":69,"props":413,"children":414},{},[415],{"type":66,"value":416},"Manage multiple Airflow instances with persistent configuration:",{"type":60,"tag":106,"props":418,"children":420},{"className":108,"code":419,"language":110,"meta":111,"style":111},"# Add a new instance\naf instance add prod --url https:\u002F\u002Fairflow.example.com --token \"$API_TOKEN\"\naf instance add staging --url https:\u002F\u002Fstaging.example.com --username admin --password admin\n\n# List and switch instances\naf instance list      # Shows all instances in a table\naf instance use prod  # Switch to prod instance\naf instance current   # Show current instance\naf instance delete old-instance\n\n# Auto-discover instances (use --dry-run to preview first)\naf instance discover --dry-run        # Preview all discoverable instances\naf instance discover                  # Discover from all backends (astro, local)\naf instance discover astro            # Discover Astro deployments only\naf instance discover astro --all-workspaces  # Include all accessible workspaces\naf instance discover local            # Scan common local Airflow ports\naf instance discover local --scan     # Deep scan all ports 1024-65535\n\n# IMPORTANT: Always run with --dry-run first and ask for user consent before\n# running discover without it. The non-dry-run mode creates API tokens in\n# Astro Cloud, which is a sensitive action that requires explicit approval.\n\n# Show where an instance came from (file path + scope)\naf instance show prod\n\n# Override instance for a single command via env vars\nAIRFLOW_API_URL=https:\u002F\u002Fstaging.example.com AIRFLOW_AUTH_TOKEN=$STG af dags list\n\n# Or switch persistently\naf instance use staging\n",[421],{"type":60,"tag":75,"props":422,"children":423},{"__ignoreMap":111},[424,432,486,535,542,550,571,596,617,638,645,653,679,699,724,753,779,809,817,826,835,844,852,861,883,891,900,947,955,964],{"type":60,"tag":117,"props":425,"children":426},{"class":119,"line":120},[427],{"type":60,"tag":117,"props":428,"children":429},{"style":124},[430],{"type":66,"value":431},"# Add a new instance\n",{"type":60,"tag":117,"props":433,"children":434},{"class":119,"line":130},[435,439,444,449,454,459,464,469,475,481],{"type":60,"tag":117,"props":436,"children":437},{"style":134},[438],{"type":66,"value":80},{"type":60,"tag":117,"props":440,"children":441},{"style":140},[442],{"type":66,"value":443}," instance",{"type":60,"tag":117,"props":445,"children":446},{"style":140},[447],{"type":66,"value":448}," add",{"type":60,"tag":117,"props":450,"children":451},{"style":140},[452],{"type":66,"value":453}," prod",{"type":60,"tag":117,"props":455,"children":456},{"style":140},[457],{"type":66,"value":458}," --url",{"type":60,"tag":117,"props":460,"children":461},{"style":140},[462],{"type":66,"value":463}," https:\u002F\u002Fairflow.example.com",{"type":60,"tag":117,"props":465,"children":466},{"style":140},[467],{"type":66,"value":468}," --token",{"type":60,"tag":117,"props":470,"children":472},{"style":471},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[473],{"type":66,"value":474}," \"",{"type":60,"tag":117,"props":476,"children":478},{"style":477},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[479],{"type":66,"value":480},"$API_TOKEN",{"type":60,"tag":117,"props":482,"children":483},{"style":471},[484],{"type":66,"value":485},"\"\n",{"type":60,"tag":117,"props":487,"children":488},{"class":119,"line":151},[489,493,497,501,506,510,515,520,525,530],{"type":60,"tag":117,"props":490,"children":491},{"style":134},[492],{"type":66,"value":80},{"type":60,"tag":117,"props":494,"children":495},{"style":140},[496],{"type":66,"value":443},{"type":60,"tag":117,"props":498,"children":499},{"style":140},[500],{"type":66,"value":448},{"type":60,"tag":117,"props":502,"children":503},{"style":140},[504],{"type":66,"value":505}," staging",{"type":60,"tag":117,"props":507,"children":508},{"style":140},[509],{"type":66,"value":458},{"type":60,"tag":117,"props":511,"children":512},{"style":140},[513],{"type":66,"value":514}," https:\u002F\u002Fstaging.example.com",{"type":60,"tag":117,"props":516,"children":517},{"style":140},[518],{"type":66,"value":519}," --username",{"type":60,"tag":117,"props":521,"children":522},{"style":140},[523],{"type":66,"value":524}," admin",{"type":60,"tag":117,"props":526,"children":527},{"style":140},[528],{"type":66,"value":529}," --password",{"type":60,"tag":117,"props":531,"children":532},{"style":140},[533],{"type":66,"value":534}," admin\n",{"type":60,"tag":117,"props":536,"children":537},{"class":119,"line":161},[538],{"type":60,"tag":117,"props":539,"children":540},{"emptyLinePlaceholder":155},[541],{"type":66,"value":158},{"type":60,"tag":117,"props":543,"children":544},{"class":119,"line":170},[545],{"type":60,"tag":117,"props":546,"children":547},{"style":124},[548],{"type":66,"value":549},"# List and switch instances\n",{"type":60,"tag":117,"props":551,"children":552},{"class":119,"line":187},[553,557,561,566],{"type":60,"tag":117,"props":554,"children":555},{"style":134},[556],{"type":66,"value":80},{"type":60,"tag":117,"props":558,"children":559},{"style":140},[560],{"type":66,"value":443},{"type":60,"tag":117,"props":562,"children":563},{"style":140},[564],{"type":66,"value":565}," list",{"type":60,"tag":117,"props":567,"children":568},{"style":124},[569],{"type":66,"value":570},"      # Shows all instances in a table\n",{"type":60,"tag":117,"props":572,"children":573},{"class":119,"line":195},[574,578,582,587,591],{"type":60,"tag":117,"props":575,"children":576},{"style":134},[577],{"type":66,"value":80},{"type":60,"tag":117,"props":579,"children":580},{"style":140},[581],{"type":66,"value":443},{"type":60,"tag":117,"props":583,"children":584},{"style":140},[585],{"type":66,"value":586}," use",{"type":60,"tag":117,"props":588,"children":589},{"style":140},[590],{"type":66,"value":453},{"type":60,"tag":117,"props":592,"children":593},{"style":124},[594],{"type":66,"value":595},"  # Switch to prod instance\n",{"type":60,"tag":117,"props":597,"children":598},{"class":119,"line":204},[599,603,607,612],{"type":60,"tag":117,"props":600,"children":601},{"style":134},[602],{"type":66,"value":80},{"type":60,"tag":117,"props":604,"children":605},{"style":140},[606],{"type":66,"value":443},{"type":60,"tag":117,"props":608,"children":609},{"style":140},[610],{"type":66,"value":611}," current",{"type":60,"tag":117,"props":613,"children":614},{"style":124},[615],{"type":66,"value":616},"   # Show current instance\n",{"type":60,"tag":117,"props":618,"children":619},{"class":119,"line":221},[620,624,628,633],{"type":60,"tag":117,"props":621,"children":622},{"style":134},[623],{"type":66,"value":80},{"type":60,"tag":117,"props":625,"children":626},{"style":140},[627],{"type":66,"value":443},{"type":60,"tag":117,"props":629,"children":630},{"style":140},[631],{"type":66,"value":632}," delete",{"type":60,"tag":117,"props":634,"children":635},{"style":140},[636],{"type":66,"value":637}," old-instance\n",{"type":60,"tag":117,"props":639,"children":640},{"class":119,"line":229},[641],{"type":60,"tag":117,"props":642,"children":643},{"emptyLinePlaceholder":155},[644],{"type":66,"value":158},{"type":60,"tag":117,"props":646,"children":647},{"class":119,"line":238},[648],{"type":60,"tag":117,"props":649,"children":650},{"style":124},[651],{"type":66,"value":652},"# Auto-discover instances (use --dry-run to preview first)\n",{"type":60,"tag":117,"props":654,"children":655},{"class":119,"line":255},[656,660,664,669,674],{"type":60,"tag":117,"props":657,"children":658},{"style":134},[659],{"type":66,"value":80},{"type":60,"tag":117,"props":661,"children":662},{"style":140},[663],{"type":66,"value":443},{"type":60,"tag":117,"props":665,"children":666},{"style":140},[667],{"type":66,"value":668}," discover",{"type":60,"tag":117,"props":670,"children":671},{"style":140},[672],{"type":66,"value":673}," --dry-run",{"type":60,"tag":117,"props":675,"children":676},{"style":124},[677],{"type":66,"value":678},"        # Preview all discoverable instances\n",{"type":60,"tag":117,"props":680,"children":681},{"class":119,"line":263},[682,686,690,694],{"type":60,"tag":117,"props":683,"children":684},{"style":134},[685],{"type":66,"value":80},{"type":60,"tag":117,"props":687,"children":688},{"style":140},[689],{"type":66,"value":443},{"type":60,"tag":117,"props":691,"children":692},{"style":140},[693],{"type":66,"value":668},{"type":60,"tag":117,"props":695,"children":696},{"style":124},[697],{"type":66,"value":698},"                  # Discover from all backends (astro, local)\n",{"type":60,"tag":117,"props":700,"children":701},{"class":119,"line":272},[702,706,710,714,719],{"type":60,"tag":117,"props":703,"children":704},{"style":134},[705],{"type":66,"value":80},{"type":60,"tag":117,"props":707,"children":708},{"style":140},[709],{"type":66,"value":443},{"type":60,"tag":117,"props":711,"children":712},{"style":140},[713],{"type":66,"value":668},{"type":60,"tag":117,"props":715,"children":716},{"style":140},[717],{"type":66,"value":718}," astro",{"type":60,"tag":117,"props":720,"children":721},{"style":124},[722],{"type":66,"value":723},"            # Discover Astro deployments only\n",{"type":60,"tag":117,"props":725,"children":726},{"class":119,"line":290},[727,731,735,739,743,748],{"type":60,"tag":117,"props":728,"children":729},{"style":134},[730],{"type":66,"value":80},{"type":60,"tag":117,"props":732,"children":733},{"style":140},[734],{"type":66,"value":443},{"type":60,"tag":117,"props":736,"children":737},{"style":140},[738],{"type":66,"value":668},{"type":60,"tag":117,"props":740,"children":741},{"style":140},[742],{"type":66,"value":718},{"type":60,"tag":117,"props":744,"children":745},{"style":140},[746],{"type":66,"value":747}," --all-workspaces",{"type":60,"tag":117,"props":749,"children":750},{"style":124},[751],{"type":66,"value":752},"  # Include all accessible workspaces\n",{"type":60,"tag":117,"props":754,"children":756},{"class":119,"line":755},16,[757,761,765,769,774],{"type":60,"tag":117,"props":758,"children":759},{"style":134},[760],{"type":66,"value":80},{"type":60,"tag":117,"props":762,"children":763},{"style":140},[764],{"type":66,"value":443},{"type":60,"tag":117,"props":766,"children":767},{"style":140},[768],{"type":66,"value":668},{"type":60,"tag":117,"props":770,"children":771},{"style":140},[772],{"type":66,"value":773}," local",{"type":60,"tag":117,"props":775,"children":776},{"style":124},[777],{"type":66,"value":778},"            # Scan common local Airflow ports\n",{"type":60,"tag":117,"props":780,"children":782},{"class":119,"line":781},17,[783,787,791,795,799,804],{"type":60,"tag":117,"props":784,"children":785},{"style":134},[786],{"type":66,"value":80},{"type":60,"tag":117,"props":788,"children":789},{"style":140},[790],{"type":66,"value":443},{"type":60,"tag":117,"props":792,"children":793},{"style":140},[794],{"type":66,"value":668},{"type":60,"tag":117,"props":796,"children":797},{"style":140},[798],{"type":66,"value":773},{"type":60,"tag":117,"props":800,"children":801},{"style":140},[802],{"type":66,"value":803}," --scan",{"type":60,"tag":117,"props":805,"children":806},{"style":124},[807],{"type":66,"value":808},"     # Deep scan all ports 1024-65535\n",{"type":60,"tag":117,"props":810,"children":812},{"class":119,"line":811},18,[813],{"type":60,"tag":117,"props":814,"children":815},{"emptyLinePlaceholder":155},[816],{"type":66,"value":158},{"type":60,"tag":117,"props":818,"children":820},{"class":119,"line":819},19,[821],{"type":60,"tag":117,"props":822,"children":823},{"style":124},[824],{"type":66,"value":825},"# IMPORTANT: Always run with --dry-run first and ask for user consent before\n",{"type":60,"tag":117,"props":827,"children":829},{"class":119,"line":828},20,[830],{"type":60,"tag":117,"props":831,"children":832},{"style":124},[833],{"type":66,"value":834},"# running discover without it. The non-dry-run mode creates API tokens in\n",{"type":60,"tag":117,"props":836,"children":838},{"class":119,"line":837},21,[839],{"type":60,"tag":117,"props":840,"children":841},{"style":124},[842],{"type":66,"value":843},"# Astro Cloud, which is a sensitive action that requires explicit approval.\n",{"type":60,"tag":117,"props":845,"children":847},{"class":119,"line":846},22,[848],{"type":60,"tag":117,"props":849,"children":850},{"emptyLinePlaceholder":155},[851],{"type":66,"value":158},{"type":60,"tag":117,"props":853,"children":855},{"class":119,"line":854},23,[856],{"type":60,"tag":117,"props":857,"children":858},{"style":124},[859],{"type":66,"value":860},"# Show where an instance came from (file path + scope)\n",{"type":60,"tag":117,"props":862,"children":864},{"class":119,"line":863},24,[865,869,873,878],{"type":60,"tag":117,"props":866,"children":867},{"style":134},[868],{"type":66,"value":80},{"type":60,"tag":117,"props":870,"children":871},{"style":140},[872],{"type":66,"value":443},{"type":60,"tag":117,"props":874,"children":875},{"style":140},[876],{"type":66,"value":877}," show",{"type":60,"tag":117,"props":879,"children":880},{"style":140},[881],{"type":66,"value":882}," prod\n",{"type":60,"tag":117,"props":884,"children":886},{"class":119,"line":885},25,[887],{"type":60,"tag":117,"props":888,"children":889},{"emptyLinePlaceholder":155},[890],{"type":66,"value":158},{"type":60,"tag":117,"props":892,"children":894},{"class":119,"line":893},26,[895],{"type":60,"tag":117,"props":896,"children":897},{"style":124},[898],{"type":66,"value":899},"# Override instance for a single command via env vars\n",{"type":60,"tag":117,"props":901,"children":903},{"class":119,"line":902},27,[904,909,914,919,924,928,933,937,942],{"type":60,"tag":117,"props":905,"children":906},{"style":477},[907],{"type":66,"value":908},"AIRFLOW_API_URL",{"type":60,"tag":117,"props":910,"children":911},{"style":471},[912],{"type":66,"value":913},"=",{"type":60,"tag":117,"props":915,"children":916},{"style":140},[917],{"type":66,"value":918},"https:\u002F\u002Fstaging.example.com",{"type":60,"tag":117,"props":920,"children":921},{"style":477},[922],{"type":66,"value":923}," AIRFLOW_AUTH_TOKEN",{"type":60,"tag":117,"props":925,"children":926},{"style":471},[927],{"type":66,"value":913},{"type":60,"tag":117,"props":929,"children":930},{"style":477},[931],{"type":66,"value":932},"$STG ",{"type":60,"tag":117,"props":934,"children":935},{"style":134},[936],{"type":66,"value":80},{"type":60,"tag":117,"props":938,"children":939},{"style":140},[940],{"type":66,"value":941}," dags",{"type":60,"tag":117,"props":943,"children":944},{"style":140},[945],{"type":66,"value":946}," list\n",{"type":60,"tag":117,"props":948,"children":950},{"class":119,"line":949},28,[951],{"type":60,"tag":117,"props":952,"children":953},{"emptyLinePlaceholder":155},[954],{"type":66,"value":158},{"type":60,"tag":117,"props":956,"children":958},{"class":119,"line":957},29,[959],{"type":60,"tag":117,"props":960,"children":961},{"style":124},[962],{"type":66,"value":963},"# Or switch persistently\n",{"type":60,"tag":117,"props":965,"children":967},{"class":119,"line":966},30,[968,972,976,980],{"type":60,"tag":117,"props":969,"children":970},{"style":134},[971],{"type":66,"value":80},{"type":60,"tag":117,"props":973,"children":974},{"style":140},[975],{"type":66,"value":443},{"type":60,"tag":117,"props":977,"children":978},{"style":140},[979],{"type":66,"value":586},{"type":60,"tag":117,"props":981,"children":982},{"style":140},[983],{"type":66,"value":984}," staging\n",{"type":60,"tag":69,"props":986,"children":987},{},[988,990,996],{"type":66,"value":989},"Config layout (mirrors ",{"type":60,"tag":75,"props":991,"children":993},{"className":992},[],[994],{"type":66,"value":995},"git config",{"type":66,"value":997}," system\u002Fglobal\u002Flocal):",{"type":60,"tag":999,"props":1000,"children":1001},"table",{},[1002,1026],{"type":60,"tag":1003,"props":1004,"children":1005},"thead",{},[1006],{"type":60,"tag":1007,"props":1008,"children":1009},"tr",{},[1010,1016,1021],{"type":60,"tag":1011,"props":1012,"children":1013},"th",{},[1014],{"type":66,"value":1015},"Scope",{"type":60,"tag":1011,"props":1017,"children":1018},{},[1019],{"type":66,"value":1020},"File",{"type":60,"tag":1011,"props":1022,"children":1023},{},[1024],{"type":66,"value":1025},"Committed?",{"type":60,"tag":1027,"props":1028,"children":1029},"tbody",{},[1030,1053,1075],{"type":60,"tag":1007,"props":1031,"children":1032},{},[1033,1039,1048],{"type":60,"tag":1034,"props":1035,"children":1036},"td",{},[1037],{"type":66,"value":1038},"Global",{"type":60,"tag":1034,"props":1040,"children":1041},{},[1042],{"type":60,"tag":75,"props":1043,"children":1045},{"className":1044},[],[1046],{"type":66,"value":1047},"~\u002F.astro\u002Fconfig.yaml",{"type":60,"tag":1034,"props":1049,"children":1050},{},[1051],{"type":66,"value":1052},"n\u002Fa (per-user)",{"type":60,"tag":1007,"props":1054,"children":1055},{},[1056,1061,1070],{"type":60,"tag":1034,"props":1057,"children":1058},{},[1059],{"type":66,"value":1060},"Project shared",{"type":60,"tag":1034,"props":1062,"children":1063},{},[1064],{"type":60,"tag":75,"props":1065,"children":1067},{"className":1066},[],[1068],{"type":66,"value":1069},"\u003Croot>\u002F.astro\u002Fconfig.yaml",{"type":60,"tag":1034,"props":1071,"children":1072},{},[1073],{"type":66,"value":1074},"yes",{"type":60,"tag":1007,"props":1076,"children":1077},{},[1078,1083,1092],{"type":60,"tag":1034,"props":1079,"children":1080},{},[1081],{"type":66,"value":1082},"Project local",{"type":60,"tag":1034,"props":1084,"children":1085},{},[1086],{"type":60,"tag":75,"props":1087,"children":1089},{"className":1088},[],[1090],{"type":66,"value":1091},"\u003Croot>\u002F.astro\u002Fconfig.local.yaml",{"type":60,"tag":1034,"props":1093,"children":1094},{},[1095],{"type":66,"value":1096},"no (gitignored)",{"type":60,"tag":69,"props":1098,"children":1099},{},[1100,1106,1108,1114,1116,1122,1124,1130,1132,1138,1140,1146,1148,1154,1155,1161,1163,1169],{"type":60,"tag":75,"props":1101,"children":1103},{"className":1102},[],[1104],{"type":66,"value":1105},"\u003Croot>",{"type":66,"value":1107}," is found by walking up from cwd looking for ",{"type":60,"tag":75,"props":1109,"children":1111},{"className":1110},[],[1112],{"type":66,"value":1113},".astro\u002F",{"type":66,"value":1115},". Default write routing inside a project: ",{"type":60,"tag":75,"props":1117,"children":1119},{"className":1118},[],[1120],{"type":66,"value":1121},"add",{"type":66,"value":1123},"\u002F",{"type":60,"tag":75,"props":1125,"children":1127},{"className":1126},[],[1128],{"type":66,"value":1129},"discover",{"type":66,"value":1131}," → project-shared, ",{"type":60,"tag":75,"props":1133,"children":1135},{"className":1134},[],[1136],{"type":66,"value":1137},"use",{"type":66,"value":1139}," → project-local. Override with ",{"type":60,"tag":75,"props":1141,"children":1143},{"className":1142},[],[1144],{"type":66,"value":1145},"--global",{"type":66,"value":1147}," \u002F ",{"type":60,"tag":75,"props":1149,"children":1151},{"className":1150},[],[1152],{"type":66,"value":1153},"--project",{"type":66,"value":1147},{"type":60,"tag":75,"props":1156,"children":1158},{"className":1157},[],[1159],{"type":66,"value":1160},"--local",{"type":66,"value":1162},". Set ",{"type":60,"tag":75,"props":1164,"children":1166},{"className":1165},[],[1167],{"type":66,"value":1168},"AF_CONFIG=\u003Cpath>",{"type":66,"value":1170}," to bypass layering and use a single file.",{"type":60,"tag":69,"props":1172,"children":1173},{},[1174,1176,1182,1184,1190,1192,1198],{"type":66,"value":1175},"Migrate from the legacy ",{"type":60,"tag":75,"props":1177,"children":1179},{"className":1178},[],[1180],{"type":66,"value":1181},"~\u002F.af\u002Fconfig.yaml",{"type":66,"value":1183}," with ",{"type":60,"tag":75,"props":1185,"children":1187},{"className":1186},[],[1188],{"type":66,"value":1189},"af migrate",{"type":66,"value":1191}," (idempotent; renames the old file to ",{"type":60,"tag":75,"props":1193,"children":1195},{"className":1194},[],[1196],{"type":66,"value":1197},".bak",{"type":66,"value":1199},").",{"type":60,"tag":69,"props":1201,"children":1202},{},[1203,1205,1211],{"type":66,"value":1204},"Tokens in config can reference environment variables using ",{"type":60,"tag":75,"props":1206,"children":1208},{"className":1207},[],[1209],{"type":66,"value":1210},"${VAR}",{"type":66,"value":1212}," syntax:",{"type":60,"tag":106,"props":1214,"children":1218},{"className":1215,"code":1216,"language":1217,"meta":111,"style":111},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","instances:\n- name: prod\n  url: https:\u002F\u002Fairflow.example.com\n  auth:\n    token: ${AIRFLOW_API_TOKEN}\n","yaml",[1219],{"type":60,"tag":75,"props":1220,"children":1221},{"__ignoreMap":111},[1222,1236,1258,1275,1287],{"type":60,"tag":117,"props":1223,"children":1224},{"class":119,"line":120},[1225,1231],{"type":60,"tag":117,"props":1226,"children":1228},{"style":1227},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1229],{"type":66,"value":1230},"instances",{"type":60,"tag":117,"props":1232,"children":1233},{"style":471},[1234],{"type":66,"value":1235},":\n",{"type":60,"tag":117,"props":1237,"children":1238},{"class":119,"line":130},[1239,1244,1249,1254],{"type":60,"tag":117,"props":1240,"children":1241},{"style":471},[1242],{"type":66,"value":1243},"-",{"type":60,"tag":117,"props":1245,"children":1246},{"style":1227},[1247],{"type":66,"value":1248}," name",{"type":60,"tag":117,"props":1250,"children":1251},{"style":471},[1252],{"type":66,"value":1253},":",{"type":60,"tag":117,"props":1255,"children":1256},{"style":140},[1257],{"type":66,"value":882},{"type":60,"tag":117,"props":1259,"children":1260},{"class":119,"line":151},[1261,1266,1270],{"type":60,"tag":117,"props":1262,"children":1263},{"style":1227},[1264],{"type":66,"value":1265},"  url",{"type":60,"tag":117,"props":1267,"children":1268},{"style":471},[1269],{"type":66,"value":1253},{"type":60,"tag":117,"props":1271,"children":1272},{"style":140},[1273],{"type":66,"value":1274}," https:\u002F\u002Fairflow.example.com\n",{"type":60,"tag":117,"props":1276,"children":1277},{"class":119,"line":161},[1278,1283],{"type":60,"tag":117,"props":1279,"children":1280},{"style":1227},[1281],{"type":66,"value":1282},"  auth",{"type":60,"tag":117,"props":1284,"children":1285},{"style":471},[1286],{"type":66,"value":1235},{"type":60,"tag":117,"props":1288,"children":1289},{"class":119,"line":170},[1290,1295,1299],{"type":60,"tag":117,"props":1291,"children":1292},{"style":1227},[1293],{"type":66,"value":1294},"    token",{"type":60,"tag":117,"props":1296,"children":1297},{"style":471},[1298],{"type":66,"value":1253},{"type":60,"tag":117,"props":1300,"children":1301},{"style":140},[1302],{"type":66,"value":1303}," ${AIRFLOW_API_TOKEN}\n",{"type":60,"tag":69,"props":1305,"children":1306},{},[1307],{"type":66,"value":1308},"Or use environment variables directly (no config file needed):",{"type":60,"tag":106,"props":1310,"children":1312},{"className":108,"code":1311,"language":110,"meta":111,"style":111},"export AIRFLOW_API_URL=http:\u002F\u002Flocalhost:8080\nexport AIRFLOW_AUTH_TOKEN=your-token-here\n# Or username\u002Fpassword:\nexport AIRFLOW_USERNAME=admin\nexport AIRFLOW_PASSWORD=admin\n",[1313],{"type":60,"tag":75,"props":1314,"children":1315},{"__ignoreMap":111},[1316,1339,1359,1367,1388],{"type":60,"tag":117,"props":1317,"children":1318},{"class":119,"line":120},[1319,1325,1330,1334],{"type":60,"tag":117,"props":1320,"children":1322},{"style":1321},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1323],{"type":66,"value":1324},"export",{"type":60,"tag":117,"props":1326,"children":1327},{"style":477},[1328],{"type":66,"value":1329}," AIRFLOW_API_URL",{"type":60,"tag":117,"props":1331,"children":1332},{"style":471},[1333],{"type":66,"value":913},{"type":60,"tag":117,"props":1335,"children":1336},{"style":477},[1337],{"type":66,"value":1338},"http:\u002F\u002Flocalhost:8080\n",{"type":60,"tag":117,"props":1340,"children":1341},{"class":119,"line":130},[1342,1346,1350,1354],{"type":60,"tag":117,"props":1343,"children":1344},{"style":1321},[1345],{"type":66,"value":1324},{"type":60,"tag":117,"props":1347,"children":1348},{"style":477},[1349],{"type":66,"value":923},{"type":60,"tag":117,"props":1351,"children":1352},{"style":471},[1353],{"type":66,"value":913},{"type":60,"tag":117,"props":1355,"children":1356},{"style":477},[1357],{"type":66,"value":1358},"your-token-here\n",{"type":60,"tag":117,"props":1360,"children":1361},{"class":119,"line":151},[1362],{"type":60,"tag":117,"props":1363,"children":1364},{"style":124},[1365],{"type":66,"value":1366},"# Or username\u002Fpassword:\n",{"type":60,"tag":117,"props":1368,"children":1369},{"class":119,"line":161},[1370,1374,1379,1383],{"type":60,"tag":117,"props":1371,"children":1372},{"style":1321},[1373],{"type":66,"value":1324},{"type":60,"tag":117,"props":1375,"children":1376},{"style":477},[1377],{"type":66,"value":1378}," AIRFLOW_USERNAME",{"type":60,"tag":117,"props":1380,"children":1381},{"style":471},[1382],{"type":66,"value":913},{"type":60,"tag":117,"props":1384,"children":1385},{"style":477},[1386],{"type":66,"value":1387},"admin\n",{"type":60,"tag":117,"props":1389,"children":1390},{"class":119,"line":170},[1391,1395,1400,1404],{"type":60,"tag":117,"props":1392,"children":1393},{"style":1321},[1394],{"type":66,"value":1324},{"type":60,"tag":117,"props":1396,"children":1397},{"style":477},[1398],{"type":66,"value":1399}," AIRFLOW_PASSWORD",{"type":60,"tag":117,"props":1401,"children":1402},{"style":471},[1403],{"type":66,"value":913},{"type":60,"tag":117,"props":1405,"children":1406},{"style":477},[1407],{"type":66,"value":1387},{"type":60,"tag":69,"props":1409,"children":1410},{},[1411,1413],{"type":66,"value":1412},"Or CLI flags: ",{"type":60,"tag":75,"props":1414,"children":1416},{"className":1415},[],[1417],{"type":66,"value":1418},"af --airflow-url http:\u002F\u002Flocalhost:8080 --token \"$TOKEN\" \u003Ccommand>",{"type":60,"tag":84,"props":1420,"children":1422},{"id":1421},"quick-reference",[1423],{"type":66,"value":1424},"Quick Reference",{"type":60,"tag":999,"props":1426,"children":1427},{},[1428,1444],{"type":60,"tag":1003,"props":1429,"children":1430},{},[1431],{"type":60,"tag":1007,"props":1432,"children":1433},{},[1434,1439],{"type":60,"tag":1011,"props":1435,"children":1436},{},[1437],{"type":66,"value":1438},"Command",{"type":60,"tag":1011,"props":1440,"children":1441},{},[1442],{"type":66,"value":1443},"Description",{"type":60,"tag":1027,"props":1445,"children":1446},{},[1447,1464,1481,1498,1515,1532,1549,1566,1583,1600,1617,1634,1651,1668,1685,1702,1719,1736,1753,1770,1787,1804,1821,1838,1855,1872,1889,1906,1923,1940,1957,1974,1991,2008,2025,2042,2059,2076],{"type":60,"tag":1007,"props":1448,"children":1449},{},[1450,1459],{"type":60,"tag":1034,"props":1451,"children":1452},{},[1453],{"type":60,"tag":75,"props":1454,"children":1456},{"className":1455},[],[1457],{"type":66,"value":1458},"af health",{"type":60,"tag":1034,"props":1460,"children":1461},{},[1462],{"type":66,"value":1463},"System health check",{"type":60,"tag":1007,"props":1465,"children":1466},{},[1467,1476],{"type":60,"tag":1034,"props":1468,"children":1469},{},[1470],{"type":60,"tag":75,"props":1471,"children":1473},{"className":1472},[],[1474],{"type":66,"value":1475},"af dags list",{"type":60,"tag":1034,"props":1477,"children":1478},{},[1479],{"type":66,"value":1480},"List all DAGs",{"type":60,"tag":1007,"props":1482,"children":1483},{},[1484,1493],{"type":60,"tag":1034,"props":1485,"children":1486},{},[1487],{"type":60,"tag":75,"props":1488,"children":1490},{"className":1489},[],[1491],{"type":66,"value":1492},"af dags get \u003Cdag_id>",{"type":60,"tag":1034,"props":1494,"children":1495},{},[1496],{"type":66,"value":1497},"Get DAG details",{"type":60,"tag":1007,"props":1499,"children":1500},{},[1501,1510],{"type":60,"tag":1034,"props":1502,"children":1503},{},[1504],{"type":60,"tag":75,"props":1505,"children":1507},{"className":1506},[],[1508],{"type":66,"value":1509},"af dags explore \u003Cdag_id>",{"type":60,"tag":1034,"props":1511,"children":1512},{},[1513],{"type":66,"value":1514},"Full DAG investigation",{"type":60,"tag":1007,"props":1516,"children":1517},{},[1518,1527],{"type":60,"tag":1034,"props":1519,"children":1520},{},[1521],{"type":60,"tag":75,"props":1522,"children":1524},{"className":1523},[],[1525],{"type":66,"value":1526},"af dags source \u003Cdag_id>",{"type":60,"tag":1034,"props":1528,"children":1529},{},[1530],{"type":66,"value":1531},"Get DAG source code",{"type":60,"tag":1007,"props":1533,"children":1534},{},[1535,1544],{"type":60,"tag":1034,"props":1536,"children":1537},{},[1538],{"type":60,"tag":75,"props":1539,"children":1541},{"className":1540},[],[1542],{"type":66,"value":1543},"af dags pause \u003Cdag_id>",{"type":60,"tag":1034,"props":1545,"children":1546},{},[1547],{"type":66,"value":1548},"Pause DAG scheduling",{"type":60,"tag":1007,"props":1550,"children":1551},{},[1552,1561],{"type":60,"tag":1034,"props":1553,"children":1554},{},[1555],{"type":60,"tag":75,"props":1556,"children":1558},{"className":1557},[],[1559],{"type":66,"value":1560},"af dags unpause \u003Cdag_id>",{"type":60,"tag":1034,"props":1562,"children":1563},{},[1564],{"type":66,"value":1565},"Resume DAG scheduling",{"type":60,"tag":1007,"props":1567,"children":1568},{},[1569,1578],{"type":60,"tag":1034,"props":1570,"children":1571},{},[1572],{"type":60,"tag":75,"props":1573,"children":1575},{"className":1574},[],[1576],{"type":66,"value":1577},"af dags errors",{"type":60,"tag":1034,"props":1579,"children":1580},{},[1581],{"type":66,"value":1582},"List import errors",{"type":60,"tag":1007,"props":1584,"children":1585},{},[1586,1595],{"type":60,"tag":1034,"props":1587,"children":1588},{},[1589],{"type":60,"tag":75,"props":1590,"children":1592},{"className":1591},[],[1593],{"type":66,"value":1594},"af dags warnings",{"type":60,"tag":1034,"props":1596,"children":1597},{},[1598],{"type":66,"value":1599},"List DAG warnings",{"type":60,"tag":1007,"props":1601,"children":1602},{},[1603,1612],{"type":60,"tag":1034,"props":1604,"children":1605},{},[1606],{"type":60,"tag":75,"props":1607,"children":1609},{"className":1608},[],[1610],{"type":66,"value":1611},"af dags stats",{"type":60,"tag":1034,"props":1613,"children":1614},{},[1615],{"type":66,"value":1616},"DAG run statistics",{"type":60,"tag":1007,"props":1618,"children":1619},{},[1620,1629],{"type":60,"tag":1034,"props":1621,"children":1622},{},[1623],{"type":60,"tag":75,"props":1624,"children":1626},{"className":1625},[],[1627],{"type":66,"value":1628},"af runs list",{"type":60,"tag":1034,"props":1630,"children":1631},{},[1632],{"type":66,"value":1633},"List DAG runs",{"type":60,"tag":1007,"props":1635,"children":1636},{},[1637,1646],{"type":60,"tag":1034,"props":1638,"children":1639},{},[1640],{"type":60,"tag":75,"props":1641,"children":1643},{"className":1642},[],[1644],{"type":66,"value":1645},"af runs get \u003Cdag_id> \u003Crun_id>",{"type":60,"tag":1034,"props":1647,"children":1648},{},[1649],{"type":66,"value":1650},"Get run details",{"type":60,"tag":1007,"props":1652,"children":1653},{},[1654,1663],{"type":60,"tag":1034,"props":1655,"children":1656},{},[1657],{"type":60,"tag":75,"props":1658,"children":1660},{"className":1659},[],[1661],{"type":66,"value":1662},"af runs trigger \u003Cdag_id>",{"type":60,"tag":1034,"props":1664,"children":1665},{},[1666],{"type":66,"value":1667},"Trigger a DAG run",{"type":60,"tag":1007,"props":1669,"children":1670},{},[1671,1680],{"type":60,"tag":1034,"props":1672,"children":1673},{},[1674],{"type":60,"tag":75,"props":1675,"children":1677},{"className":1676},[],[1678],{"type":66,"value":1679},"af runs trigger-wait \u003Cdag_id>",{"type":60,"tag":1034,"props":1681,"children":1682},{},[1683],{"type":66,"value":1684},"Trigger and wait for completion",{"type":60,"tag":1007,"props":1686,"children":1687},{},[1688,1697],{"type":60,"tag":1034,"props":1689,"children":1690},{},[1691],{"type":60,"tag":75,"props":1692,"children":1694},{"className":1693},[],[1695],{"type":66,"value":1696},"af runs delete \u003Cdag_id> \u003Crun_id>",{"type":60,"tag":1034,"props":1698,"children":1699},{},[1700],{"type":66,"value":1701},"Permanently delete a DAG run",{"type":60,"tag":1007,"props":1703,"children":1704},{},[1705,1714],{"type":60,"tag":1034,"props":1706,"children":1707},{},[1708],{"type":60,"tag":75,"props":1709,"children":1711},{"className":1710},[],[1712],{"type":66,"value":1713},"af runs clear \u003Cdag_id> \u003Crun_id>",{"type":60,"tag":1034,"props":1715,"children":1716},{},[1717],{"type":66,"value":1718},"Clear a run for re-execution",{"type":60,"tag":1007,"props":1720,"children":1721},{},[1722,1731],{"type":60,"tag":1034,"props":1723,"children":1724},{},[1725],{"type":60,"tag":75,"props":1726,"children":1728},{"className":1727},[],[1729],{"type":66,"value":1730},"af runs diagnose \u003Cdag_id> \u003Crun_id>",{"type":60,"tag":1034,"props":1732,"children":1733},{},[1734],{"type":66,"value":1735},"Diagnose failed run",{"type":60,"tag":1007,"props":1737,"children":1738},{},[1739,1748],{"type":60,"tag":1034,"props":1740,"children":1741},{},[1742],{"type":60,"tag":75,"props":1743,"children":1745},{"className":1744},[],[1746],{"type":66,"value":1747},"af tasks list \u003Cdag_id>",{"type":60,"tag":1034,"props":1749,"children":1750},{},[1751],{"type":66,"value":1752},"List tasks in DAG",{"type":60,"tag":1007,"props":1754,"children":1755},{},[1756,1765],{"type":60,"tag":1034,"props":1757,"children":1758},{},[1759],{"type":60,"tag":75,"props":1760,"children":1762},{"className":1761},[],[1763],{"type":66,"value":1764},"af tasks get \u003Cdag_id> \u003Ctask_id>",{"type":60,"tag":1034,"props":1766,"children":1767},{},[1768],{"type":66,"value":1769},"Get task definition",{"type":60,"tag":1007,"props":1771,"children":1772},{},[1773,1782],{"type":60,"tag":1034,"props":1774,"children":1775},{},[1776],{"type":60,"tag":75,"props":1777,"children":1779},{"className":1778},[],[1780],{"type":66,"value":1781},"af tasks instance \u003Cdag_id> \u003Crun_id> \u003Ctask_id>",{"type":60,"tag":1034,"props":1783,"children":1784},{},[1785],{"type":66,"value":1786},"Get task instance",{"type":60,"tag":1007,"props":1788,"children":1789},{},[1790,1799],{"type":60,"tag":1034,"props":1791,"children":1792},{},[1793],{"type":60,"tag":75,"props":1794,"children":1796},{"className":1795},[],[1797],{"type":66,"value":1798},"af tasks logs \u003Cdag_id> \u003Crun_id> \u003Ctask_id>",{"type":60,"tag":1034,"props":1800,"children":1801},{},[1802],{"type":66,"value":1803},"Get task logs",{"type":60,"tag":1007,"props":1805,"children":1806},{},[1807,1816],{"type":60,"tag":1034,"props":1808,"children":1809},{},[1810],{"type":60,"tag":75,"props":1811,"children":1813},{"className":1812},[],[1814],{"type":66,"value":1815},"af config version",{"type":60,"tag":1034,"props":1817,"children":1818},{},[1819],{"type":66,"value":1820},"Airflow version",{"type":60,"tag":1007,"props":1822,"children":1823},{},[1824,1833],{"type":60,"tag":1034,"props":1825,"children":1826},{},[1827],{"type":60,"tag":75,"props":1828,"children":1830},{"className":1829},[],[1831],{"type":66,"value":1832},"af config show",{"type":60,"tag":1034,"props":1834,"children":1835},{},[1836],{"type":66,"value":1837},"Full configuration",{"type":60,"tag":1007,"props":1839,"children":1840},{},[1841,1850],{"type":60,"tag":1034,"props":1842,"children":1843},{},[1844],{"type":60,"tag":75,"props":1845,"children":1847},{"className":1846},[],[1848],{"type":66,"value":1849},"af config connections",{"type":60,"tag":1034,"props":1851,"children":1852},{},[1853],{"type":66,"value":1854},"List connections",{"type":60,"tag":1007,"props":1856,"children":1857},{},[1858,1867],{"type":60,"tag":1034,"props":1859,"children":1860},{},[1861],{"type":60,"tag":75,"props":1862,"children":1864},{"className":1863},[],[1865],{"type":66,"value":1866},"af config variables",{"type":60,"tag":1034,"props":1868,"children":1869},{},[1870],{"type":66,"value":1871},"List variables",{"type":60,"tag":1007,"props":1873,"children":1874},{},[1875,1884],{"type":60,"tag":1034,"props":1876,"children":1877},{},[1878],{"type":60,"tag":75,"props":1879,"children":1881},{"className":1880},[],[1882],{"type":66,"value":1883},"af config variable \u003Ckey>",{"type":60,"tag":1034,"props":1885,"children":1886},{},[1887],{"type":66,"value":1888},"Get specific variable",{"type":60,"tag":1007,"props":1890,"children":1891},{},[1892,1901],{"type":60,"tag":1034,"props":1893,"children":1894},{},[1895],{"type":60,"tag":75,"props":1896,"children":1898},{"className":1897},[],[1899],{"type":66,"value":1900},"af config pools",{"type":60,"tag":1034,"props":1902,"children":1903},{},[1904],{"type":66,"value":1905},"List pools",{"type":60,"tag":1007,"props":1907,"children":1908},{},[1909,1918],{"type":60,"tag":1034,"props":1910,"children":1911},{},[1912],{"type":60,"tag":75,"props":1913,"children":1915},{"className":1914},[],[1916],{"type":66,"value":1917},"af config pool \u003Cname>",{"type":60,"tag":1034,"props":1919,"children":1920},{},[1921],{"type":66,"value":1922},"Get pool details",{"type":60,"tag":1007,"props":1924,"children":1925},{},[1926,1935],{"type":60,"tag":1034,"props":1927,"children":1928},{},[1929],{"type":60,"tag":75,"props":1930,"children":1932},{"className":1931},[],[1933],{"type":66,"value":1934},"af config plugins",{"type":60,"tag":1034,"props":1936,"children":1937},{},[1938],{"type":66,"value":1939},"List plugins",{"type":60,"tag":1007,"props":1941,"children":1942},{},[1943,1952],{"type":60,"tag":1034,"props":1944,"children":1945},{},[1946],{"type":60,"tag":75,"props":1947,"children":1949},{"className":1948},[],[1950],{"type":66,"value":1951},"af config providers",{"type":60,"tag":1034,"props":1953,"children":1954},{},[1955],{"type":66,"value":1956},"List providers",{"type":60,"tag":1007,"props":1958,"children":1959},{},[1960,1969],{"type":60,"tag":1034,"props":1961,"children":1962},{},[1963],{"type":60,"tag":75,"props":1964,"children":1966},{"className":1965},[],[1967],{"type":66,"value":1968},"af config assets",{"type":60,"tag":1034,"props":1970,"children":1971},{},[1972],{"type":66,"value":1973},"List assets\u002Fdatasets",{"type":60,"tag":1007,"props":1975,"children":1976},{},[1977,1986],{"type":60,"tag":1034,"props":1978,"children":1979},{},[1980],{"type":60,"tag":75,"props":1981,"children":1983},{"className":1982},[],[1984],{"type":66,"value":1985},"af api \u003Cendpoint>",{"type":60,"tag":1034,"props":1987,"children":1988},{},[1989],{"type":66,"value":1990},"Direct REST API access",{"type":60,"tag":1007,"props":1992,"children":1993},{},[1994,2003],{"type":60,"tag":1034,"props":1995,"children":1996},{},[1997],{"type":60,"tag":75,"props":1998,"children":2000},{"className":1999},[],[2001],{"type":66,"value":2002},"af api ls",{"type":60,"tag":1034,"props":2004,"children":2005},{},[2006],{"type":66,"value":2007},"List available API endpoints",{"type":60,"tag":1007,"props":2009,"children":2010},{},[2011,2020],{"type":60,"tag":1034,"props":2012,"children":2013},{},[2014],{"type":60,"tag":75,"props":2015,"children":2017},{"className":2016},[],[2018],{"type":66,"value":2019},"af api ls --filter X",{"type":60,"tag":1034,"props":2021,"children":2022},{},[2023],{"type":66,"value":2024},"List endpoints matching pattern",{"type":60,"tag":1007,"props":2026,"children":2027},{},[2028,2037],{"type":60,"tag":1034,"props":2029,"children":2030},{},[2031],{"type":60,"tag":75,"props":2032,"children":2034},{"className":2033},[],[2035],{"type":66,"value":2036},"af registry providers",{"type":60,"tag":1034,"props":2038,"children":2039},{},[2040],{"type":66,"value":2041},"List providers in the Airflow Registry",{"type":60,"tag":1007,"props":2043,"children":2044},{},[2045,2054],{"type":60,"tag":1034,"props":2046,"children":2047},{},[2048],{"type":60,"tag":75,"props":2049,"children":2051},{"className":2050},[],[2052],{"type":66,"value":2053},"af registry modules \u003Cprovider>",{"type":60,"tag":1034,"props":2055,"children":2056},{},[2057],{"type":66,"value":2058},"List operators\u002Fhooks\u002Fsensors\u002Ftransfers in a provider",{"type":60,"tag":1007,"props":2060,"children":2061},{},[2062,2071],{"type":60,"tag":1034,"props":2063,"children":2064},{},[2065],{"type":60,"tag":75,"props":2066,"children":2068},{"className":2067},[],[2069],{"type":66,"value":2070},"af registry parameters \u003Cprovider>",{"type":60,"tag":1034,"props":2072,"children":2073},{},[2074],{"type":66,"value":2075},"Constructor signatures (name, type, default, required) for a provider's classes",{"type":60,"tag":1007,"props":2077,"children":2078},{},[2079,2088],{"type":60,"tag":1034,"props":2080,"children":2081},{},[2082],{"type":60,"tag":75,"props":2083,"children":2085},{"className":2084},[],[2086],{"type":66,"value":2087},"af registry connections \u003Cprovider>",{"type":60,"tag":1034,"props":2089,"children":2090},{},[2091],{"type":66,"value":2092},"Connection types a provider exposes",{"type":60,"tag":84,"props":2094,"children":2096},{"id":2095},"user-intent-patterns",[2097],{"type":66,"value":2098},"User Intent Patterns",{"type":60,"tag":2100,"props":2101,"children":2103},"h3",{"id":2102},"getting-started",[2104],{"type":66,"value":2105},"Getting Started",{"type":60,"tag":316,"props":2107,"children":2108},{},[2109,2120,2130],{"type":60,"tag":320,"props":2110,"children":2111},{},[2112,2114,2118],{"type":66,"value":2113},"\"How do I run Airflow locally?\" \u002F \"Set up Airflow\" -> use the ",{"type":60,"tag":324,"props":2115,"children":2116},{},[2117],{"type":66,"value":351},{"type":66,"value":2119}," skill (uses Astro CLI)",{"type":60,"tag":320,"props":2121,"children":2122},{},[2123,2125,2129],{"type":66,"value":2124},"\"Create a new Airflow project\" \u002F \"Initialize project\" -> use the ",{"type":60,"tag":324,"props":2126,"children":2127},{},[2128],{"type":66,"value":335},{"type":66,"value":2119},{"type":60,"tag":320,"props":2131,"children":2132},{},[2133,2135,2139],{"type":66,"value":2134},"\"How do I install Airflow?\" \u002F \"Get started with Airflow\" -> use the ",{"type":60,"tag":324,"props":2136,"children":2137},{},[2138],{"type":66,"value":335},{"type":66,"value":337},{"type":60,"tag":2100,"props":2141,"children":2143},{"id":2142},"dag-operations",[2144],{"type":66,"value":2145},"DAG Operations",{"type":60,"tag":316,"props":2147,"children":2148},{},[2149,2159,2169,2179,2189,2199,2209,2219],{"type":60,"tag":320,"props":2150,"children":2151},{},[2152,2154],{"type":66,"value":2153},"\"What DAGs exist?\" \u002F \"List all DAGs\" -> ",{"type":60,"tag":75,"props":2155,"children":2157},{"className":2156},[],[2158],{"type":66,"value":1475},{"type":60,"tag":320,"props":2160,"children":2161},{},[2162,2164],{"type":66,"value":2163},"\"Tell me about DAG X\" \u002F \"What is DAG Y?\" -> ",{"type":60,"tag":75,"props":2165,"children":2167},{"className":2166},[],[2168],{"type":66,"value":1509},{"type":60,"tag":320,"props":2170,"children":2171},{},[2172,2174],{"type":66,"value":2173},"\"What's the schedule for DAG X?\" -> ",{"type":60,"tag":75,"props":2175,"children":2177},{"className":2176},[],[2178],{"type":66,"value":1492},{"type":60,"tag":320,"props":2180,"children":2181},{},[2182,2184],{"type":66,"value":2183},"\"Show me the code for DAG X\" -> ",{"type":60,"tag":75,"props":2185,"children":2187},{"className":2186},[],[2188],{"type":66,"value":1526},{"type":60,"tag":320,"props":2190,"children":2191},{},[2192,2194],{"type":66,"value":2193},"\"Stop DAG X\" \u002F \"Pause this workflow\" -> ",{"type":60,"tag":75,"props":2195,"children":2197},{"className":2196},[],[2198],{"type":66,"value":1543},{"type":60,"tag":320,"props":2200,"children":2201},{},[2202,2204],{"type":66,"value":2203},"\"Resume DAG X\" -> ",{"type":60,"tag":75,"props":2205,"children":2207},{"className":2206},[],[2208],{"type":66,"value":1560},{"type":60,"tag":320,"props":2210,"children":2211},{},[2212,2214],{"type":66,"value":2213},"\"Are there any DAG errors?\" -> ",{"type":60,"tag":75,"props":2215,"children":2217},{"className":2216},[],[2218],{"type":66,"value":1577},{"type":60,"tag":320,"props":2220,"children":2221},{},[2222,2224,2229],{"type":66,"value":2223},"\"Create a new DAG\" \u002F \"Write a pipeline\" -> use the ",{"type":60,"tag":324,"props":2225,"children":2226},{},[2227],{"type":66,"value":2228},"authoring-dags",{"type":66,"value":337},{"type":60,"tag":2100,"props":2231,"children":2233},{"id":2232},"run-operations",[2234],{"type":66,"value":2235},"Run Operations",{"type":60,"tag":316,"props":2237,"children":2238},{},[2239,2249,2259,2269,2279,2289,2299],{"type":60,"tag":320,"props":2240,"children":2241},{},[2242,2244],{"type":66,"value":2243},"\"What runs have executed?\" -> ",{"type":60,"tag":75,"props":2245,"children":2247},{"className":2246},[],[2248],{"type":66,"value":1628},{"type":60,"tag":320,"props":2250,"children":2251},{},[2252,2254],{"type":66,"value":2253},"\"Run DAG X\" \u002F \"Trigger the pipeline\" -> ",{"type":60,"tag":75,"props":2255,"children":2257},{"className":2256},[],[2258],{"type":66,"value":1662},{"type":60,"tag":320,"props":2260,"children":2261},{},[2262,2264],{"type":66,"value":2263},"\"Run DAG X and wait\" -> ",{"type":60,"tag":75,"props":2265,"children":2267},{"className":2266},[],[2268],{"type":66,"value":1679},{"type":60,"tag":320,"props":2270,"children":2271},{},[2272,2274],{"type":66,"value":2273},"\"Why did this run fail?\" -> ",{"type":60,"tag":75,"props":2275,"children":2277},{"className":2276},[],[2278],{"type":66,"value":1730},{"type":60,"tag":320,"props":2280,"children":2281},{},[2282,2284],{"type":66,"value":2283},"\"Delete this run\" \u002F \"Remove stuck run\" -> ",{"type":60,"tag":75,"props":2285,"children":2287},{"className":2286},[],[2288],{"type":66,"value":1696},{"type":60,"tag":320,"props":2290,"children":2291},{},[2292,2294],{"type":66,"value":2293},"\"Clear this run\" \u002F \"Retry this run\" \u002F \"Re-run this\" -> ",{"type":60,"tag":75,"props":2295,"children":2297},{"className":2296},[],[2298],{"type":66,"value":1713},{"type":60,"tag":320,"props":2300,"children":2301},{},[2302,2304,2309],{"type":66,"value":2303},"\"Test this DAG and fix if it fails\" -> use the ",{"type":60,"tag":324,"props":2305,"children":2306},{},[2307],{"type":66,"value":2308},"testing-dags",{"type":66,"value":337},{"type":60,"tag":2100,"props":2311,"children":2313},{"id":2312},"task-operations",[2314],{"type":66,"value":2315},"Task Operations",{"type":60,"tag":316,"props":2317,"children":2318},{},[2319,2329,2339],{"type":60,"tag":320,"props":2320,"children":2321},{},[2322,2324],{"type":66,"value":2323},"\"What tasks are in DAG X?\" -> ",{"type":60,"tag":75,"props":2325,"children":2327},{"className":2326},[],[2328],{"type":66,"value":1747},{"type":60,"tag":320,"props":2330,"children":2331},{},[2332,2334],{"type":66,"value":2333},"\"Get task logs\" \u002F \"Why did task fail?\" -> ",{"type":60,"tag":75,"props":2335,"children":2337},{"className":2336},[],[2338],{"type":66,"value":1798},{"type":60,"tag":320,"props":2340,"children":2341},{},[2342,2344,2349],{"type":66,"value":2343},"\"Full root cause analysis\" \u002F \"Diagnose and fix\" -> use the ",{"type":60,"tag":324,"props":2345,"children":2346},{},[2347],{"type":66,"value":2348},"debugging-dags",{"type":66,"value":337},{"type":60,"tag":2100,"props":2351,"children":2353},{"id":2352},"data-operations",[2354],{"type":66,"value":2355},"Data Operations",{"type":60,"tag":316,"props":2357,"children":2358},{},[2359,2370,2381],{"type":60,"tag":320,"props":2360,"children":2361},{},[2362,2364,2369],{"type":66,"value":2363},"\"Is the data fresh?\" \u002F \"When was this table last updated?\" -> use the ",{"type":60,"tag":324,"props":2365,"children":2366},{},[2367],{"type":66,"value":2368},"checking-freshness",{"type":66,"value":337},{"type":60,"tag":320,"props":2371,"children":2372},{},[2373,2375,2380],{"type":66,"value":2374},"\"Where does this data come from?\" -> use the ",{"type":60,"tag":324,"props":2376,"children":2377},{},[2378],{"type":66,"value":2379},"tracing-upstream-lineage",{"type":66,"value":337},{"type":60,"tag":320,"props":2382,"children":2383},{},[2384,2386,2391],{"type":66,"value":2385},"\"What depends on this table?\" \u002F \"What breaks if I change this?\" -> use the ",{"type":60,"tag":324,"props":2387,"children":2388},{},[2389],{"type":66,"value":2390},"tracing-downstream-lineage",{"type":66,"value":337},{"type":60,"tag":2100,"props":2393,"children":2395},{"id":2394},"deployment-operations",[2396],{"type":66,"value":2397},"Deployment Operations",{"type":60,"tag":316,"props":2399,"children":2400},{},[2401,2411,2421,2431],{"type":60,"tag":320,"props":2402,"children":2403},{},[2404,2406,2410],{"type":66,"value":2405},"\"Deploy my DAGs\" \u002F \"Push to production\" -> use the ",{"type":60,"tag":324,"props":2407,"children":2408},{},[2409],{"type":66,"value":366},{"type":66,"value":337},{"type":60,"tag":320,"props":2412,"children":2413},{},[2414,2416,2420],{"type":66,"value":2415},"\"Set up CI\u002FCD\" \u002F \"Automate deploys\" -> use the ",{"type":60,"tag":324,"props":2417,"children":2418},{},[2419],{"type":66,"value":366},{"type":66,"value":337},{"type":60,"tag":320,"props":2422,"children":2423},{},[2424,2426,2430],{"type":66,"value":2425},"\"Deploy to Kubernetes\" \u002F \"Set up Helm\" -> use the ",{"type":60,"tag":324,"props":2427,"children":2428},{},[2429],{"type":66,"value":366},{"type":66,"value":337},{"type":60,"tag":320,"props":2432,"children":2433},{},[2434,2436,2440],{"type":66,"value":2435},"\"astro deploy\" \u002F \"DAG-only deploy\" -> use the ",{"type":60,"tag":324,"props":2437,"children":2438},{},[2439],{"type":66,"value":366},{"type":66,"value":337},{"type":60,"tag":2100,"props":2442,"children":2444},{"id":2443},"system-operations",[2445],{"type":66,"value":2446},"System Operations",{"type":60,"tag":316,"props":2448,"children":2449},{},[2450,2460,2470,2480],{"type":60,"tag":320,"props":2451,"children":2452},{},[2453,2455],{"type":66,"value":2454},"\"What version of Airflow?\" -> ",{"type":60,"tag":75,"props":2456,"children":2458},{"className":2457},[],[2459],{"type":66,"value":1815},{"type":60,"tag":320,"props":2461,"children":2462},{},[2463,2465],{"type":66,"value":2464},"\"What connections exist?\" -> ",{"type":60,"tag":75,"props":2466,"children":2468},{"className":2467},[],[2469],{"type":66,"value":1849},{"type":60,"tag":320,"props":2471,"children":2472},{},[2473,2475],{"type":66,"value":2474},"\"Are pools full?\" -> ",{"type":60,"tag":75,"props":2476,"children":2478},{"className":2477},[],[2479],{"type":66,"value":1900},{"type":60,"tag":320,"props":2481,"children":2482},{},[2483,2485],{"type":66,"value":2484},"\"Is Airflow healthy?\" -> ",{"type":60,"tag":75,"props":2486,"children":2488},{"className":2487},[],[2489],{"type":66,"value":1458},{"type":60,"tag":2100,"props":2491,"children":2493},{"id":2492},"api-exploration",[2494],{"type":66,"value":2495},"API Exploration",{"type":60,"tag":316,"props":2497,"children":2498},{},[2499,2509,2520,2531,2542,2553],{"type":60,"tag":320,"props":2500,"children":2501},{},[2502,2504],{"type":66,"value":2503},"\"What API endpoints are available?\" -> ",{"type":60,"tag":75,"props":2505,"children":2507},{"className":2506},[],[2508],{"type":66,"value":2002},{"type":60,"tag":320,"props":2510,"children":2511},{},[2512,2514],{"type":66,"value":2513},"\"Find variable endpoints\" -> ",{"type":60,"tag":75,"props":2515,"children":2517},{"className":2516},[],[2518],{"type":66,"value":2519},"af api ls --filter variable",{"type":60,"tag":320,"props":2521,"children":2522},{},[2523,2525],{"type":66,"value":2524},"\"Access XCom values\" \u002F \"Get XCom\" -> ",{"type":60,"tag":75,"props":2526,"children":2528},{"className":2527},[],[2529],{"type":66,"value":2530},"af api xcom-entries -F dag_id=X -F task_id=Y",{"type":60,"tag":320,"props":2532,"children":2533},{},[2534,2536],{"type":66,"value":2535},"\"Get event logs\" \u002F \"Audit trail\" -> ",{"type":60,"tag":75,"props":2537,"children":2539},{"className":2538},[],[2540],{"type":66,"value":2541},"af api event-logs -F dag_id=X",{"type":60,"tag":320,"props":2543,"children":2544},{},[2545,2547],{"type":66,"value":2546},"\"Create connection via API\" -> ",{"type":60,"tag":75,"props":2548,"children":2550},{"className":2549},[],[2551],{"type":66,"value":2552},"af api connections -X POST --body '{...}'",{"type":60,"tag":320,"props":2554,"children":2555},{},[2556,2558],{"type":66,"value":2557},"\"Create variable via API\" -> ",{"type":60,"tag":75,"props":2559,"children":2561},{"className":2560},[],[2562],{"type":66,"value":2563},"af api variables -X POST -F key=name -f value=val",{"type":60,"tag":2100,"props":2565,"children":2567},{"id":2566},"registry-discovery",[2568],{"type":66,"value":2569},"Registry Discovery",{"type":60,"tag":316,"props":2571,"children":2572},{},[2573,2583,2593,2603,2613],{"type":60,"tag":320,"props":2574,"children":2575},{},[2576,2578],{"type":66,"value":2577},"\"What operators does provider X have?\" -> ",{"type":60,"tag":75,"props":2579,"children":2581},{"className":2580},[],[2582],{"type":66,"value":2053},{"type":60,"tag":320,"props":2584,"children":2585},{},[2586,2588],{"type":66,"value":2587},"\"What are the constructor params for operator Y?\" -> ",{"type":60,"tag":75,"props":2589,"children":2591},{"className":2590},[],[2592],{"type":66,"value":2070},{"type":60,"tag":320,"props":2594,"children":2595},{},[2596,2598],{"type":66,"value":2597},"\"What providers exist?\" \u002F \"Is there a provider for Z?\" -> ",{"type":60,"tag":75,"props":2599,"children":2601},{"className":2600},[],[2602],{"type":66,"value":2036},{"type":60,"tag":320,"props":2604,"children":2605},{},[2606,2608],{"type":66,"value":2607},"\"What connection types does provider X expose?\" -> ",{"type":60,"tag":75,"props":2609,"children":2611},{"className":2610},[],[2612],{"type":66,"value":2087},{"type":60,"tag":320,"props":2614,"children":2615},{},[2616],{"type":66,"value":2617},"\"Writing a DAG with a specific operator\" -> use registry to verify current signature before copying examples",{"type":60,"tag":84,"props":2619,"children":2621},{"id":2620},"common-workflows",[2622],{"type":66,"value":2623},"Common Workflows",{"type":60,"tag":2100,"props":2625,"children":2627},{"id":2626},"validate-dags-before-deploying",[2628],{"type":66,"value":2629},"Validate DAGs Before Deploying",{"type":60,"tag":69,"props":2631,"children":2632},{},[2633],{"type":66,"value":2634},"If you're using the Astro CLI, you can validate DAGs without a running Airflow instance:",{"type":60,"tag":106,"props":2636,"children":2638},{"className":108,"code":2637,"language":110,"meta":111,"style":111},"# Parse DAGs to catch import errors and syntax issues\nastro dev parse\n\n# Run unit tests\nastro dev pytest\n",[2639],{"type":60,"tag":75,"props":2640,"children":2641},{"__ignoreMap":111},[2642,2650,2665,2672,2680],{"type":60,"tag":117,"props":2643,"children":2644},{"class":119,"line":120},[2645],{"type":60,"tag":117,"props":2646,"children":2647},{"style":124},[2648],{"type":66,"value":2649},"# Parse DAGs to catch import errors and syntax issues\n",{"type":60,"tag":117,"props":2651,"children":2652},{"class":119,"line":130},[2653,2657,2661],{"type":60,"tag":117,"props":2654,"children":2655},{"style":134},[2656],{"type":66,"value":137},{"type":60,"tag":117,"props":2658,"children":2659},{"style":140},[2660],{"type":66,"value":143},{"type":60,"tag":117,"props":2662,"children":2663},{"style":140},[2664],{"type":66,"value":218},{"type":60,"tag":117,"props":2666,"children":2667},{"class":119,"line":151},[2668],{"type":60,"tag":117,"props":2669,"children":2670},{"emptyLinePlaceholder":155},[2671],{"type":66,"value":158},{"type":60,"tag":117,"props":2673,"children":2674},{"class":119,"line":161},[2675],{"type":60,"tag":117,"props":2676,"children":2677},{"style":124},[2678],{"type":66,"value":2679},"# Run unit tests\n",{"type":60,"tag":117,"props":2681,"children":2682},{"class":119,"line":170},[2683,2687,2691],{"type":60,"tag":117,"props":2684,"children":2685},{"style":134},[2686],{"type":66,"value":137},{"type":60,"tag":117,"props":2688,"children":2689},{"style":140},[2690],{"type":66,"value":143},{"type":60,"tag":117,"props":2692,"children":2693},{"style":140},[2694],{"type":66,"value":252},{"type":60,"tag":69,"props":2696,"children":2697},{},[2698],{"type":66,"value":2699},"Otherwise, validate against a running instance:",{"type":60,"tag":106,"props":2701,"children":2703},{"className":108,"code":2702,"language":110,"meta":111,"style":111},"af dags errors     # Check for parse\u002Fimport errors\naf dags warnings   # Check for deprecation warnings\n",[2704],{"type":60,"tag":75,"props":2705,"children":2706},{"__ignoreMap":111},[2707,2728],{"type":60,"tag":117,"props":2708,"children":2709},{"class":119,"line":120},[2710,2714,2718,2723],{"type":60,"tag":117,"props":2711,"children":2712},{"style":134},[2713],{"type":66,"value":80},{"type":60,"tag":117,"props":2715,"children":2716},{"style":140},[2717],{"type":66,"value":941},{"type":60,"tag":117,"props":2719,"children":2720},{"style":140},[2721],{"type":66,"value":2722}," errors",{"type":60,"tag":117,"props":2724,"children":2725},{"style":124},[2726],{"type":66,"value":2727},"     # Check for parse\u002Fimport errors\n",{"type":60,"tag":117,"props":2729,"children":2730},{"class":119,"line":130},[2731,2735,2739,2744],{"type":60,"tag":117,"props":2732,"children":2733},{"style":134},[2734],{"type":66,"value":80},{"type":60,"tag":117,"props":2736,"children":2737},{"style":140},[2738],{"type":66,"value":941},{"type":60,"tag":117,"props":2740,"children":2741},{"style":140},[2742],{"type":66,"value":2743}," warnings",{"type":60,"tag":117,"props":2745,"children":2746},{"style":124},[2747],{"type":66,"value":2748},"   # Check for deprecation warnings\n",{"type":60,"tag":2100,"props":2750,"children":2752},{"id":2751},"discover-operator-signatures-before-writing-code",[2753],{"type":66,"value":2754},"Discover Operator Signatures Before Writing Code",{"type":60,"tag":69,"props":2756,"children":2757},{},[2758,2760,2766],{"type":66,"value":2759},"The Airflow Registry at ",{"type":60,"tag":75,"props":2761,"children":2763},{"className":2762},[],[2764],{"type":66,"value":2765},"airflow.apache.org\u002Fregistry",{"type":66,"value":2767}," is the authoritative source for provider classes and their current constructor signatures. Prefer it over memory or stale documentation when authoring DAGs — the registry reflects the live provider release.",{"type":60,"tag":106,"props":2769,"children":2771},{"className":108,"code":2770,"language":110,"meta":111,"style":111},"# List all providers and pick the one you need\naf registry providers | jq '.providers[] | {id, name, version}'\n\n# List every operator \u002F hook \u002F sensor in a provider (e.g. standard, amazon, google)\naf registry modules standard \\\n  | jq '.modules[] | {name, type, import_path, docs_url}'\n\n# Get the current constructor signature for a specific class\naf registry parameters standard \\\n  | jq '.classes[\"airflow.providers.standard.operators.hitl.ApprovalOperator\"].parameters'\n\n# Filter modules by substring (useful when you know the concept but not the class)\naf registry modules standard \\\n  | jq '.modules[] | select(.import_path | test(\"hitl\"))'\n",[2772],{"type":60,"tag":75,"props":2773,"children":2774},{"__ignoreMap":111},[2775,2783,2825,2832,2840,2866,2891,2898,2906,2930,2954,2961,2969,2992],{"type":60,"tag":117,"props":2776,"children":2777},{"class":119,"line":120},[2778],{"type":60,"tag":117,"props":2779,"children":2780},{"style":124},[2781],{"type":66,"value":2782},"# List all providers and pick the one you need\n",{"type":60,"tag":117,"props":2784,"children":2785},{"class":119,"line":130},[2786,2790,2795,2800,2805,2810,2815,2820],{"type":60,"tag":117,"props":2787,"children":2788},{"style":134},[2789],{"type":66,"value":80},{"type":60,"tag":117,"props":2791,"children":2792},{"style":140},[2793],{"type":66,"value":2794}," registry",{"type":60,"tag":117,"props":2796,"children":2797},{"style":140},[2798],{"type":66,"value":2799}," providers",{"type":60,"tag":117,"props":2801,"children":2802},{"style":471},[2803],{"type":66,"value":2804}," |",{"type":60,"tag":117,"props":2806,"children":2807},{"style":134},[2808],{"type":66,"value":2809}," jq",{"type":60,"tag":117,"props":2811,"children":2812},{"style":471},[2813],{"type":66,"value":2814}," '",{"type":60,"tag":117,"props":2816,"children":2817},{"style":140},[2818],{"type":66,"value":2819},".providers[] | {id, name, version}",{"type":60,"tag":117,"props":2821,"children":2822},{"style":471},[2823],{"type":66,"value":2824},"'\n",{"type":60,"tag":117,"props":2826,"children":2827},{"class":119,"line":151},[2828],{"type":60,"tag":117,"props":2829,"children":2830},{"emptyLinePlaceholder":155},[2831],{"type":66,"value":158},{"type":60,"tag":117,"props":2833,"children":2834},{"class":119,"line":161},[2835],{"type":60,"tag":117,"props":2836,"children":2837},{"style":124},[2838],{"type":66,"value":2839},"# List every operator \u002F hook \u002F sensor in a provider (e.g. standard, amazon, google)\n",{"type":60,"tag":117,"props":2841,"children":2842},{"class":119,"line":170},[2843,2847,2851,2856,2861],{"type":60,"tag":117,"props":2844,"children":2845},{"style":134},[2846],{"type":66,"value":80},{"type":60,"tag":117,"props":2848,"children":2849},{"style":140},[2850],{"type":66,"value":2794},{"type":60,"tag":117,"props":2852,"children":2853},{"style":140},[2854],{"type":66,"value":2855}," modules",{"type":60,"tag":117,"props":2857,"children":2858},{"style":140},[2859],{"type":66,"value":2860}," standard",{"type":60,"tag":117,"props":2862,"children":2863},{"style":477},[2864],{"type":66,"value":2865}," \\\n",{"type":60,"tag":117,"props":2867,"children":2868},{"class":119,"line":187},[2869,2874,2878,2882,2887],{"type":60,"tag":117,"props":2870,"children":2871},{"style":471},[2872],{"type":66,"value":2873},"  |",{"type":60,"tag":117,"props":2875,"children":2876},{"style":134},[2877],{"type":66,"value":2809},{"type":60,"tag":117,"props":2879,"children":2880},{"style":471},[2881],{"type":66,"value":2814},{"type":60,"tag":117,"props":2883,"children":2884},{"style":140},[2885],{"type":66,"value":2886},".modules[] | {name, type, import_path, docs_url}",{"type":60,"tag":117,"props":2888,"children":2889},{"style":471},[2890],{"type":66,"value":2824},{"type":60,"tag":117,"props":2892,"children":2893},{"class":119,"line":195},[2894],{"type":60,"tag":117,"props":2895,"children":2896},{"emptyLinePlaceholder":155},[2897],{"type":66,"value":158},{"type":60,"tag":117,"props":2899,"children":2900},{"class":119,"line":204},[2901],{"type":60,"tag":117,"props":2902,"children":2903},{"style":124},[2904],{"type":66,"value":2905},"# Get the current constructor signature for a specific class\n",{"type":60,"tag":117,"props":2907,"children":2908},{"class":119,"line":221},[2909,2913,2917,2922,2926],{"type":60,"tag":117,"props":2910,"children":2911},{"style":134},[2912],{"type":66,"value":80},{"type":60,"tag":117,"props":2914,"children":2915},{"style":140},[2916],{"type":66,"value":2794},{"type":60,"tag":117,"props":2918,"children":2919},{"style":140},[2920],{"type":66,"value":2921}," parameters",{"type":60,"tag":117,"props":2923,"children":2924},{"style":140},[2925],{"type":66,"value":2860},{"type":60,"tag":117,"props":2927,"children":2928},{"style":477},[2929],{"type":66,"value":2865},{"type":60,"tag":117,"props":2931,"children":2932},{"class":119,"line":229},[2933,2937,2941,2945,2950],{"type":60,"tag":117,"props":2934,"children":2935},{"style":471},[2936],{"type":66,"value":2873},{"type":60,"tag":117,"props":2938,"children":2939},{"style":134},[2940],{"type":66,"value":2809},{"type":60,"tag":117,"props":2942,"children":2943},{"style":471},[2944],{"type":66,"value":2814},{"type":60,"tag":117,"props":2946,"children":2947},{"style":140},[2948],{"type":66,"value":2949},".classes[\"airflow.providers.standard.operators.hitl.ApprovalOperator\"].parameters",{"type":60,"tag":117,"props":2951,"children":2952},{"style":471},[2953],{"type":66,"value":2824},{"type":60,"tag":117,"props":2955,"children":2956},{"class":119,"line":238},[2957],{"type":60,"tag":117,"props":2958,"children":2959},{"emptyLinePlaceholder":155},[2960],{"type":66,"value":158},{"type":60,"tag":117,"props":2962,"children":2963},{"class":119,"line":255},[2964],{"type":60,"tag":117,"props":2965,"children":2966},{"style":124},[2967],{"type":66,"value":2968},"# Filter modules by substring (useful when you know the concept but not the class)\n",{"type":60,"tag":117,"props":2970,"children":2971},{"class":119,"line":263},[2972,2976,2980,2984,2988],{"type":60,"tag":117,"props":2973,"children":2974},{"style":134},[2975],{"type":66,"value":80},{"type":60,"tag":117,"props":2977,"children":2978},{"style":140},[2979],{"type":66,"value":2794},{"type":60,"tag":117,"props":2981,"children":2982},{"style":140},[2983],{"type":66,"value":2855},{"type":60,"tag":117,"props":2985,"children":2986},{"style":140},[2987],{"type":66,"value":2860},{"type":60,"tag":117,"props":2989,"children":2990},{"style":477},[2991],{"type":66,"value":2865},{"type":60,"tag":117,"props":2993,"children":2994},{"class":119,"line":272},[2995,2999,3003,3007,3012],{"type":60,"tag":117,"props":2996,"children":2997},{"style":471},[2998],{"type":66,"value":2873},{"type":60,"tag":117,"props":3000,"children":3001},{"style":134},[3002],{"type":66,"value":2809},{"type":60,"tag":117,"props":3004,"children":3005},{"style":471},[3006],{"type":66,"value":2814},{"type":60,"tag":117,"props":3008,"children":3009},{"style":140},[3010],{"type":66,"value":3011},".modules[] | select(.import_path | test(\"hitl\"))",{"type":60,"tag":117,"props":3013,"children":3014},{"style":471},[3015],{"type":66,"value":2824},{"type":60,"tag":69,"props":3017,"children":3018},{},[3019,3021,3027,3029,3035,3036,3042,3043,3049],{"type":66,"value":3020},"Results are cached locally: 1 hour for the latest version, 30 days for pinned versions (which are immutable). Add ",{"type":60,"tag":75,"props":3022,"children":3024},{"className":3023},[],[3025],{"type":66,"value":3026},"--version X.Y.Z",{"type":66,"value":3028}," to any ",{"type":60,"tag":75,"props":3030,"children":3032},{"className":3031},[],[3033],{"type":66,"value":3034},"modules",{"type":66,"value":1147},{"type":60,"tag":75,"props":3037,"children":3039},{"className":3038},[],[3040],{"type":66,"value":3041},"parameters",{"type":66,"value":1147},{"type":60,"tag":75,"props":3044,"children":3046},{"className":3045},[],[3047],{"type":66,"value":3048},"connections",{"type":66,"value":3050}," call to target a specific release.",{"type":60,"tag":2100,"props":3052,"children":3054},{"id":3053},"investigate-a-failed-run",[3055],{"type":66,"value":3056},"Investigate a Failed Run",{"type":60,"tag":106,"props":3058,"children":3060},{"className":108,"code":3059,"language":110,"meta":111,"style":111},"# 1. List recent runs to find failure\naf runs list --dag-id my_dag\n\n# 2. Diagnose the specific run\naf runs diagnose my_dag manual__2024-01-15T10:00:00+00:00\n\n# 3. Get logs for failed task (from diagnose output)\naf tasks logs my_dag manual__2024-01-15T10:00:00+00:00 extract_data\n\n# 4. After fixing, clear the run to retry all tasks\naf runs clear my_dag manual__2024-01-15T10:00:00+00:00\n",[3061],{"type":60,"tag":75,"props":3062,"children":3063},{"__ignoreMap":111},[3064,3072,3098,3105,3113,3139,3146,3154,3185,3192,3200],{"type":60,"tag":117,"props":3065,"children":3066},{"class":119,"line":120},[3067],{"type":60,"tag":117,"props":3068,"children":3069},{"style":124},[3070],{"type":66,"value":3071},"# 1. List recent runs to find failure\n",{"type":60,"tag":117,"props":3073,"children":3074},{"class":119,"line":130},[3075,3079,3084,3088,3093],{"type":60,"tag":117,"props":3076,"children":3077},{"style":134},[3078],{"type":66,"value":80},{"type":60,"tag":117,"props":3080,"children":3081},{"style":140},[3082],{"type":66,"value":3083}," runs",{"type":60,"tag":117,"props":3085,"children":3086},{"style":140},[3087],{"type":66,"value":565},{"type":60,"tag":117,"props":3089,"children":3090},{"style":140},[3091],{"type":66,"value":3092}," --dag-id",{"type":60,"tag":117,"props":3094,"children":3095},{"style":140},[3096],{"type":66,"value":3097}," my_dag\n",{"type":60,"tag":117,"props":3099,"children":3100},{"class":119,"line":151},[3101],{"type":60,"tag":117,"props":3102,"children":3103},{"emptyLinePlaceholder":155},[3104],{"type":66,"value":158},{"type":60,"tag":117,"props":3106,"children":3107},{"class":119,"line":161},[3108],{"type":60,"tag":117,"props":3109,"children":3110},{"style":124},[3111],{"type":66,"value":3112},"# 2. Diagnose the specific run\n",{"type":60,"tag":117,"props":3114,"children":3115},{"class":119,"line":170},[3116,3120,3124,3129,3134],{"type":60,"tag":117,"props":3117,"children":3118},{"style":134},[3119],{"type":66,"value":80},{"type":60,"tag":117,"props":3121,"children":3122},{"style":140},[3123],{"type":66,"value":3083},{"type":60,"tag":117,"props":3125,"children":3126},{"style":140},[3127],{"type":66,"value":3128}," diagnose",{"type":60,"tag":117,"props":3130,"children":3131},{"style":140},[3132],{"type":66,"value":3133}," my_dag",{"type":60,"tag":117,"props":3135,"children":3136},{"style":140},[3137],{"type":66,"value":3138}," manual__2024-01-15T10:00:00+00:00\n",{"type":60,"tag":117,"props":3140,"children":3141},{"class":119,"line":187},[3142],{"type":60,"tag":117,"props":3143,"children":3144},{"emptyLinePlaceholder":155},[3145],{"type":66,"value":158},{"type":60,"tag":117,"props":3147,"children":3148},{"class":119,"line":195},[3149],{"type":60,"tag":117,"props":3150,"children":3151},{"style":124},[3152],{"type":66,"value":3153},"# 3. Get logs for failed task (from diagnose output)\n",{"type":60,"tag":117,"props":3155,"children":3156},{"class":119,"line":204},[3157,3161,3166,3171,3175,3180],{"type":60,"tag":117,"props":3158,"children":3159},{"style":134},[3160],{"type":66,"value":80},{"type":60,"tag":117,"props":3162,"children":3163},{"style":140},[3164],{"type":66,"value":3165}," tasks",{"type":60,"tag":117,"props":3167,"children":3168},{"style":140},[3169],{"type":66,"value":3170}," logs",{"type":60,"tag":117,"props":3172,"children":3173},{"style":140},[3174],{"type":66,"value":3133},{"type":60,"tag":117,"props":3176,"children":3177},{"style":140},[3178],{"type":66,"value":3179}," manual__2024-01-15T10:00:00+00:00",{"type":60,"tag":117,"props":3181,"children":3182},{"style":140},[3183],{"type":66,"value":3184}," extract_data\n",{"type":60,"tag":117,"props":3186,"children":3187},{"class":119,"line":221},[3188],{"type":60,"tag":117,"props":3189,"children":3190},{"emptyLinePlaceholder":155},[3191],{"type":66,"value":158},{"type":60,"tag":117,"props":3193,"children":3194},{"class":119,"line":229},[3195],{"type":60,"tag":117,"props":3196,"children":3197},{"style":124},[3198],{"type":66,"value":3199},"# 4. After fixing, clear the run to retry all tasks\n",{"type":60,"tag":117,"props":3201,"children":3202},{"class":119,"line":238},[3203,3207,3211,3216,3220],{"type":60,"tag":117,"props":3204,"children":3205},{"style":134},[3206],{"type":66,"value":80},{"type":60,"tag":117,"props":3208,"children":3209},{"style":140},[3210],{"type":66,"value":3083},{"type":60,"tag":117,"props":3212,"children":3213},{"style":140},[3214],{"type":66,"value":3215}," clear",{"type":60,"tag":117,"props":3217,"children":3218},{"style":140},[3219],{"type":66,"value":3133},{"type":60,"tag":117,"props":3221,"children":3222},{"style":140},[3223],{"type":66,"value":3138},{"type":60,"tag":2100,"props":3225,"children":3227},{"id":3226},"morning-health-check",[3228],{"type":66,"value":3229},"Morning Health Check",{"type":60,"tag":106,"props":3231,"children":3233},{"className":108,"code":3232,"language":110,"meta":111,"style":111},"# 1. Overall system health\naf health\n\n# 2. Check for broken DAGs\naf dags errors\n\n# 3. Check pool utilization\naf config pools\n",[3234],{"type":60,"tag":75,"props":3235,"children":3236},{"__ignoreMap":111},[3237,3245,3257,3264,3272,3288,3295,3303],{"type":60,"tag":117,"props":3238,"children":3239},{"class":119,"line":120},[3240],{"type":60,"tag":117,"props":3241,"children":3242},{"style":124},[3243],{"type":66,"value":3244},"# 1. Overall system health\n",{"type":60,"tag":117,"props":3246,"children":3247},{"class":119,"line":130},[3248,3252],{"type":60,"tag":117,"props":3249,"children":3250},{"style":134},[3251],{"type":66,"value":80},{"type":60,"tag":117,"props":3253,"children":3254},{"style":140},[3255],{"type":66,"value":3256}," health\n",{"type":60,"tag":117,"props":3258,"children":3259},{"class":119,"line":151},[3260],{"type":60,"tag":117,"props":3261,"children":3262},{"emptyLinePlaceholder":155},[3263],{"type":66,"value":158},{"type":60,"tag":117,"props":3265,"children":3266},{"class":119,"line":161},[3267],{"type":60,"tag":117,"props":3268,"children":3269},{"style":124},[3270],{"type":66,"value":3271},"# 2. Check for broken DAGs\n",{"type":60,"tag":117,"props":3273,"children":3274},{"class":119,"line":170},[3275,3279,3283],{"type":60,"tag":117,"props":3276,"children":3277},{"style":134},[3278],{"type":66,"value":80},{"type":60,"tag":117,"props":3280,"children":3281},{"style":140},[3282],{"type":66,"value":941},{"type":60,"tag":117,"props":3284,"children":3285},{"style":140},[3286],{"type":66,"value":3287}," errors\n",{"type":60,"tag":117,"props":3289,"children":3290},{"class":119,"line":187},[3291],{"type":60,"tag":117,"props":3292,"children":3293},{"emptyLinePlaceholder":155},[3294],{"type":66,"value":158},{"type":60,"tag":117,"props":3296,"children":3297},{"class":119,"line":195},[3298],{"type":60,"tag":117,"props":3299,"children":3300},{"style":124},[3301],{"type":66,"value":3302},"# 3. Check pool utilization\n",{"type":60,"tag":117,"props":3304,"children":3305},{"class":119,"line":204},[3306,3310,3315],{"type":60,"tag":117,"props":3307,"children":3308},{"style":134},[3309],{"type":66,"value":80},{"type":60,"tag":117,"props":3311,"children":3312},{"style":140},[3313],{"type":66,"value":3314}," config",{"type":60,"tag":117,"props":3316,"children":3317},{"style":140},[3318],{"type":66,"value":3319}," pools\n",{"type":60,"tag":2100,"props":3321,"children":3323},{"id":3322},"understand-a-dag",[3324],{"type":66,"value":3325},"Understand a DAG",{"type":60,"tag":106,"props":3327,"children":3329},{"className":108,"code":3328,"language":110,"meta":111,"style":111},"# Get comprehensive overview (metadata + tasks + source)\naf dags explore my_dag\n",[3330],{"type":60,"tag":75,"props":3331,"children":3332},{"__ignoreMap":111},[3333,3341],{"type":60,"tag":117,"props":3334,"children":3335},{"class":119,"line":120},[3336],{"type":60,"tag":117,"props":3337,"children":3338},{"style":124},[3339],{"type":66,"value":3340},"# Get comprehensive overview (metadata + tasks + source)\n",{"type":60,"tag":117,"props":3342,"children":3343},{"class":119,"line":130},[3344,3348,3352,3357],{"type":60,"tag":117,"props":3345,"children":3346},{"style":134},[3347],{"type":66,"value":80},{"type":60,"tag":117,"props":3349,"children":3350},{"style":140},[3351],{"type":66,"value":941},{"type":60,"tag":117,"props":3353,"children":3354},{"style":140},[3355],{"type":66,"value":3356}," explore",{"type":60,"tag":117,"props":3358,"children":3359},{"style":140},[3360],{"type":66,"value":3097},{"type":60,"tag":2100,"props":3362,"children":3364},{"id":3363},"check-why-dag-isnt-running",[3365],{"type":66,"value":3366},"Check Why DAG Isn't Running",{"type":60,"tag":106,"props":3368,"children":3370},{"className":108,"code":3369,"language":110,"meta":111,"style":111},"# Check if paused\naf dags get my_dag\n\n# Check for import errors\naf dags errors\n\n# Check recent runs\naf runs list --dag-id my_dag\n",[3371],{"type":60,"tag":75,"props":3372,"children":3373},{"__ignoreMap":111},[3374,3382,3402,3409,3417,3432,3439,3447],{"type":60,"tag":117,"props":3375,"children":3376},{"class":119,"line":120},[3377],{"type":60,"tag":117,"props":3378,"children":3379},{"style":124},[3380],{"type":66,"value":3381},"# Check if paused\n",{"type":60,"tag":117,"props":3383,"children":3384},{"class":119,"line":130},[3385,3389,3393,3398],{"type":60,"tag":117,"props":3386,"children":3387},{"style":134},[3388],{"type":66,"value":80},{"type":60,"tag":117,"props":3390,"children":3391},{"style":140},[3392],{"type":66,"value":941},{"type":60,"tag":117,"props":3394,"children":3395},{"style":140},[3396],{"type":66,"value":3397}," get",{"type":60,"tag":117,"props":3399,"children":3400},{"style":140},[3401],{"type":66,"value":3097},{"type":60,"tag":117,"props":3403,"children":3404},{"class":119,"line":151},[3405],{"type":60,"tag":117,"props":3406,"children":3407},{"emptyLinePlaceholder":155},[3408],{"type":66,"value":158},{"type":60,"tag":117,"props":3410,"children":3411},{"class":119,"line":161},[3412],{"type":60,"tag":117,"props":3413,"children":3414},{"style":124},[3415],{"type":66,"value":3416},"# Check for import errors\n",{"type":60,"tag":117,"props":3418,"children":3419},{"class":119,"line":170},[3420,3424,3428],{"type":60,"tag":117,"props":3421,"children":3422},{"style":134},[3423],{"type":66,"value":80},{"type":60,"tag":117,"props":3425,"children":3426},{"style":140},[3427],{"type":66,"value":941},{"type":60,"tag":117,"props":3429,"children":3430},{"style":140},[3431],{"type":66,"value":3287},{"type":60,"tag":117,"props":3433,"children":3434},{"class":119,"line":187},[3435],{"type":60,"tag":117,"props":3436,"children":3437},{"emptyLinePlaceholder":155},[3438],{"type":66,"value":158},{"type":60,"tag":117,"props":3440,"children":3441},{"class":119,"line":195},[3442],{"type":60,"tag":117,"props":3443,"children":3444},{"style":124},[3445],{"type":66,"value":3446},"# Check recent runs\n",{"type":60,"tag":117,"props":3448,"children":3449},{"class":119,"line":204},[3450,3454,3458,3462,3466],{"type":60,"tag":117,"props":3451,"children":3452},{"style":134},[3453],{"type":66,"value":80},{"type":60,"tag":117,"props":3455,"children":3456},{"style":140},[3457],{"type":66,"value":3083},{"type":60,"tag":117,"props":3459,"children":3460},{"style":140},[3461],{"type":66,"value":565},{"type":60,"tag":117,"props":3463,"children":3464},{"style":140},[3465],{"type":66,"value":3092},{"type":60,"tag":117,"props":3467,"children":3468},{"style":140},[3469],{"type":66,"value":3097},{"type":60,"tag":2100,"props":3471,"children":3473},{"id":3472},"trigger-and-monitor",[3474],{"type":66,"value":3475},"Trigger and Monitor",{"type":60,"tag":106,"props":3477,"children":3479},{"className":108,"code":3478,"language":110,"meta":111,"style":111},"# Option 1: Trigger and wait (blocking)\naf runs trigger-wait my_dag --timeout 1800\n\n# Option 2: Trigger and check later\naf runs trigger my_dag\naf runs get my_dag \u003Crun_id>\n",[3480],{"type":60,"tag":75,"props":3481,"children":3482},{"__ignoreMap":111},[3483,3491,3522,3529,3537,3557],{"type":60,"tag":117,"props":3484,"children":3485},{"class":119,"line":120},[3486],{"type":60,"tag":117,"props":3487,"children":3488},{"style":124},[3489],{"type":66,"value":3490},"# Option 1: Trigger and wait (blocking)\n",{"type":60,"tag":117,"props":3492,"children":3493},{"class":119,"line":130},[3494,3498,3502,3507,3511,3516],{"type":60,"tag":117,"props":3495,"children":3496},{"style":134},[3497],{"type":66,"value":80},{"type":60,"tag":117,"props":3499,"children":3500},{"style":140},[3501],{"type":66,"value":3083},{"type":60,"tag":117,"props":3503,"children":3504},{"style":140},[3505],{"type":66,"value":3506}," trigger-wait",{"type":60,"tag":117,"props":3508,"children":3509},{"style":140},[3510],{"type":66,"value":3133},{"type":60,"tag":117,"props":3512,"children":3513},{"style":140},[3514],{"type":66,"value":3515}," --timeout",{"type":60,"tag":117,"props":3517,"children":3519},{"style":3518},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[3520],{"type":66,"value":3521}," 1800\n",{"type":60,"tag":117,"props":3523,"children":3524},{"class":119,"line":151},[3525],{"type":60,"tag":117,"props":3526,"children":3527},{"emptyLinePlaceholder":155},[3528],{"type":66,"value":158},{"type":60,"tag":117,"props":3530,"children":3531},{"class":119,"line":161},[3532],{"type":60,"tag":117,"props":3533,"children":3534},{"style":124},[3535],{"type":66,"value":3536},"# Option 2: Trigger and check later\n",{"type":60,"tag":117,"props":3538,"children":3539},{"class":119,"line":170},[3540,3544,3548,3553],{"type":60,"tag":117,"props":3541,"children":3542},{"style":134},[3543],{"type":66,"value":80},{"type":60,"tag":117,"props":3545,"children":3546},{"style":140},[3547],{"type":66,"value":3083},{"type":60,"tag":117,"props":3549,"children":3550},{"style":140},[3551],{"type":66,"value":3552}," trigger",{"type":60,"tag":117,"props":3554,"children":3555},{"style":140},[3556],{"type":66,"value":3097},{"type":60,"tag":117,"props":3558,"children":3559},{"class":119,"line":187},[3560,3564,3568,3572,3576,3581,3586,3591],{"type":60,"tag":117,"props":3561,"children":3562},{"style":134},[3563],{"type":66,"value":80},{"type":60,"tag":117,"props":3565,"children":3566},{"style":140},[3567],{"type":66,"value":3083},{"type":60,"tag":117,"props":3569,"children":3570},{"style":140},[3571],{"type":66,"value":3397},{"type":60,"tag":117,"props":3573,"children":3574},{"style":140},[3575],{"type":66,"value":3133},{"type":60,"tag":117,"props":3577,"children":3578},{"style":471},[3579],{"type":66,"value":3580}," \u003C",{"type":60,"tag":117,"props":3582,"children":3583},{"style":140},[3584],{"type":66,"value":3585},"run_i",{"type":60,"tag":117,"props":3587,"children":3588},{"style":477},[3589],{"type":66,"value":3590},"d",{"type":60,"tag":117,"props":3592,"children":3593},{"style":471},[3594],{"type":66,"value":3595},">\n",{"type":60,"tag":84,"props":3597,"children":3599},{"id":3598},"output-format",[3600],{"type":66,"value":3601},"Output Format",{"type":60,"tag":69,"props":3603,"children":3604},{},[3605,3607,3613],{"type":66,"value":3606},"All commands output JSON (except ",{"type":60,"tag":75,"props":3608,"children":3610},{"className":3609},[],[3611],{"type":66,"value":3612},"instance",{"type":66,"value":3614}," commands which use human-readable tables):",{"type":60,"tag":106,"props":3616,"children":3618},{"className":108,"code":3617,"language":110,"meta":111,"style":111},"af dags list\n# {\n#   \"total_dags\": 5,\n#   \"returned_count\": 5,\n#   \"dags\": [...]\n# }\n",[3619],{"type":60,"tag":75,"props":3620,"children":3621},{"__ignoreMap":111},[3622,3637,3645,3653,3661,3669],{"type":60,"tag":117,"props":3623,"children":3624},{"class":119,"line":120},[3625,3629,3633],{"type":60,"tag":117,"props":3626,"children":3627},{"style":134},[3628],{"type":66,"value":80},{"type":60,"tag":117,"props":3630,"children":3631},{"style":140},[3632],{"type":66,"value":941},{"type":60,"tag":117,"props":3634,"children":3635},{"style":140},[3636],{"type":66,"value":946},{"type":60,"tag":117,"props":3638,"children":3639},{"class":119,"line":130},[3640],{"type":60,"tag":117,"props":3641,"children":3642},{"style":124},[3643],{"type":66,"value":3644},"# {\n",{"type":60,"tag":117,"props":3646,"children":3647},{"class":119,"line":151},[3648],{"type":60,"tag":117,"props":3649,"children":3650},{"style":124},[3651],{"type":66,"value":3652},"#   \"total_dags\": 5,\n",{"type":60,"tag":117,"props":3654,"children":3655},{"class":119,"line":161},[3656],{"type":60,"tag":117,"props":3657,"children":3658},{"style":124},[3659],{"type":66,"value":3660},"#   \"returned_count\": 5,\n",{"type":60,"tag":117,"props":3662,"children":3663},{"class":119,"line":170},[3664],{"type":60,"tag":117,"props":3665,"children":3666},{"style":124},[3667],{"type":66,"value":3668},"#   \"dags\": [...]\n",{"type":60,"tag":117,"props":3670,"children":3671},{"class":119,"line":187},[3672],{"type":60,"tag":117,"props":3673,"children":3674},{"style":124},[3675],{"type":66,"value":3676},"# }\n",{"type":60,"tag":69,"props":3678,"children":3679},{},[3680,3681,3687],{"type":66,"value":73},{"type":60,"tag":75,"props":3682,"children":3684},{"className":3683},[],[3685],{"type":66,"value":3686},"jq",{"type":66,"value":3688}," for filtering:",{"type":60,"tag":106,"props":3690,"children":3692},{"className":108,"code":3691,"language":110,"meta":111,"style":111},"# Find failed runs\naf runs list | jq '.dag_runs[] | select(.state == \"failed\")'\n\n# Get DAG IDs only\naf dags list | jq '.dags[].dag_id'\n\n# Find paused DAGs\naf dags list | jq '[.dags[] | select(.is_paused == true)]'\n",[3693],{"type":60,"tag":75,"props":3694,"children":3695},{"__ignoreMap":111},[3696,3704,3740,3747,3755,3791,3798,3806],{"type":60,"tag":117,"props":3697,"children":3698},{"class":119,"line":120},[3699],{"type":60,"tag":117,"props":3700,"children":3701},{"style":124},[3702],{"type":66,"value":3703},"# Find failed runs\n",{"type":60,"tag":117,"props":3705,"children":3706},{"class":119,"line":130},[3707,3711,3715,3719,3723,3727,3731,3736],{"type":60,"tag":117,"props":3708,"children":3709},{"style":134},[3710],{"type":66,"value":80},{"type":60,"tag":117,"props":3712,"children":3713},{"style":140},[3714],{"type":66,"value":3083},{"type":60,"tag":117,"props":3716,"children":3717},{"style":140},[3718],{"type":66,"value":565},{"type":60,"tag":117,"props":3720,"children":3721},{"style":471},[3722],{"type":66,"value":2804},{"type":60,"tag":117,"props":3724,"children":3725},{"style":134},[3726],{"type":66,"value":2809},{"type":60,"tag":117,"props":3728,"children":3729},{"style":471},[3730],{"type":66,"value":2814},{"type":60,"tag":117,"props":3732,"children":3733},{"style":140},[3734],{"type":66,"value":3735},".dag_runs[] | select(.state == \"failed\")",{"type":60,"tag":117,"props":3737,"children":3738},{"style":471},[3739],{"type":66,"value":2824},{"type":60,"tag":117,"props":3741,"children":3742},{"class":119,"line":151},[3743],{"type":60,"tag":117,"props":3744,"children":3745},{"emptyLinePlaceholder":155},[3746],{"type":66,"value":158},{"type":60,"tag":117,"props":3748,"children":3749},{"class":119,"line":161},[3750],{"type":60,"tag":117,"props":3751,"children":3752},{"style":124},[3753],{"type":66,"value":3754},"# Get DAG IDs only\n",{"type":60,"tag":117,"props":3756,"children":3757},{"class":119,"line":170},[3758,3762,3766,3770,3774,3778,3782,3787],{"type":60,"tag":117,"props":3759,"children":3760},{"style":134},[3761],{"type":66,"value":80},{"type":60,"tag":117,"props":3763,"children":3764},{"style":140},[3765],{"type":66,"value":941},{"type":60,"tag":117,"props":3767,"children":3768},{"style":140},[3769],{"type":66,"value":565},{"type":60,"tag":117,"props":3771,"children":3772},{"style":471},[3773],{"type":66,"value":2804},{"type":60,"tag":117,"props":3775,"children":3776},{"style":134},[3777],{"type":66,"value":2809},{"type":60,"tag":117,"props":3779,"children":3780},{"style":471},[3781],{"type":66,"value":2814},{"type":60,"tag":117,"props":3783,"children":3784},{"style":140},[3785],{"type":66,"value":3786},".dags[].dag_id",{"type":60,"tag":117,"props":3788,"children":3789},{"style":471},[3790],{"type":66,"value":2824},{"type":60,"tag":117,"props":3792,"children":3793},{"class":119,"line":187},[3794],{"type":60,"tag":117,"props":3795,"children":3796},{"emptyLinePlaceholder":155},[3797],{"type":66,"value":158},{"type":60,"tag":117,"props":3799,"children":3800},{"class":119,"line":195},[3801],{"type":60,"tag":117,"props":3802,"children":3803},{"style":124},[3804],{"type":66,"value":3805},"# Find paused DAGs\n",{"type":60,"tag":117,"props":3807,"children":3808},{"class":119,"line":204},[3809,3813,3817,3821,3825,3829,3833,3838],{"type":60,"tag":117,"props":3810,"children":3811},{"style":134},[3812],{"type":66,"value":80},{"type":60,"tag":117,"props":3814,"children":3815},{"style":140},[3816],{"type":66,"value":941},{"type":60,"tag":117,"props":3818,"children":3819},{"style":140},[3820],{"type":66,"value":565},{"type":60,"tag":117,"props":3822,"children":3823},{"style":471},[3824],{"type":66,"value":2804},{"type":60,"tag":117,"props":3826,"children":3827},{"style":134},[3828],{"type":66,"value":2809},{"type":60,"tag":117,"props":3830,"children":3831},{"style":471},[3832],{"type":66,"value":2814},{"type":60,"tag":117,"props":3834,"children":3835},{"style":140},[3836],{"type":66,"value":3837},"[.dags[] | select(.is_paused == true)]",{"type":60,"tag":117,"props":3839,"children":3840},{"style":471},[3841],{"type":66,"value":2824},{"type":60,"tag":84,"props":3843,"children":3845},{"id":3844},"task-logs-options",[3846],{"type":66,"value":3847},"Task Logs Options",{"type":60,"tag":106,"props":3849,"children":3851},{"className":108,"code":3850,"language":110,"meta":111,"style":111},"# Get logs for specific retry attempt\naf tasks logs my_dag run_id task_id --try 2\n\n# Get logs for mapped task index\naf tasks logs my_dag run_id task_id --map-index 5\n",[3852],{"type":60,"tag":75,"props":3853,"children":3854},{"__ignoreMap":111},[3855,3863,3902,3909,3917],{"type":60,"tag":117,"props":3856,"children":3857},{"class":119,"line":120},[3858],{"type":60,"tag":117,"props":3859,"children":3860},{"style":124},[3861],{"type":66,"value":3862},"# Get logs for specific retry attempt\n",{"type":60,"tag":117,"props":3864,"children":3865},{"class":119,"line":130},[3866,3870,3874,3878,3882,3887,3892,3897],{"type":60,"tag":117,"props":3867,"children":3868},{"style":134},[3869],{"type":66,"value":80},{"type":60,"tag":117,"props":3871,"children":3872},{"style":140},[3873],{"type":66,"value":3165},{"type":60,"tag":117,"props":3875,"children":3876},{"style":140},[3877],{"type":66,"value":3170},{"type":60,"tag":117,"props":3879,"children":3880},{"style":140},[3881],{"type":66,"value":3133},{"type":60,"tag":117,"props":3883,"children":3884},{"style":140},[3885],{"type":66,"value":3886}," run_id",{"type":60,"tag":117,"props":3888,"children":3889},{"style":140},[3890],{"type":66,"value":3891}," task_id",{"type":60,"tag":117,"props":3893,"children":3894},{"style":140},[3895],{"type":66,"value":3896}," --try",{"type":60,"tag":117,"props":3898,"children":3899},{"style":3518},[3900],{"type":66,"value":3901}," 2\n",{"type":60,"tag":117,"props":3903,"children":3904},{"class":119,"line":151},[3905],{"type":60,"tag":117,"props":3906,"children":3907},{"emptyLinePlaceholder":155},[3908],{"type":66,"value":158},{"type":60,"tag":117,"props":3910,"children":3911},{"class":119,"line":161},[3912],{"type":60,"tag":117,"props":3913,"children":3914},{"style":124},[3915],{"type":66,"value":3916},"# Get logs for mapped task index\n",{"type":60,"tag":117,"props":3918,"children":3919},{"class":119,"line":170},[3920,3924,3928,3932,3936,3940,3944,3949],{"type":60,"tag":117,"props":3921,"children":3922},{"style":134},[3923],{"type":66,"value":80},{"type":60,"tag":117,"props":3925,"children":3926},{"style":140},[3927],{"type":66,"value":3165},{"type":60,"tag":117,"props":3929,"children":3930},{"style":140},[3931],{"type":66,"value":3170},{"type":60,"tag":117,"props":3933,"children":3934},{"style":140},[3935],{"type":66,"value":3133},{"type":60,"tag":117,"props":3937,"children":3938},{"style":140},[3939],{"type":66,"value":3886},{"type":60,"tag":117,"props":3941,"children":3942},{"style":140},[3943],{"type":66,"value":3891},{"type":60,"tag":117,"props":3945,"children":3946},{"style":140},[3947],{"type":66,"value":3948}," --map-index",{"type":60,"tag":117,"props":3950,"children":3951},{"style":3518},[3952],{"type":66,"value":3953}," 5\n",{"type":60,"tag":84,"props":3955,"children":3957},{"id":3956},"direct-api-access-with-af-api",[3958,3960],{"type":66,"value":3959},"Direct API Access with ",{"type":60,"tag":75,"props":3961,"children":3963},{"className":3962},[],[3964],{"type":66,"value":3965},"af api",{"type":60,"tag":69,"props":3967,"children":3968},{},[3969,3970,3975],{"type":66,"value":73},{"type":60,"tag":75,"props":3971,"children":3973},{"className":3972},[],[3974],{"type":66,"value":3965},{"type":66,"value":3976}," for endpoints not covered by high-level commands (XCom, event-logs, backfills, etc).",{"type":60,"tag":106,"props":3978,"children":3980},{"className":108,"code":3979,"language":110,"meta":111,"style":111},"# Discover available endpoints\naf api ls\naf api ls --filter variable\n\n# Basic usage\naf api dags\naf api dags -F limit=10 -F only_active=true\naf api variables -X POST -F key=my_var -f value=\"my value\"\naf api variables\u002Fold_var -X DELETE\n",[3981],{"type":60,"tag":75,"props":3982,"children":3983},{"__ignoreMap":111},[3984,3992,4009,4035,4042,4050,4066,4110,4169],{"type":60,"tag":117,"props":3985,"children":3986},{"class":119,"line":120},[3987],{"type":60,"tag":117,"props":3988,"children":3989},{"style":124},[3990],{"type":66,"value":3991},"# Discover available endpoints\n",{"type":60,"tag":117,"props":3993,"children":3994},{"class":119,"line":130},[3995,3999,4004],{"type":60,"tag":117,"props":3996,"children":3997},{"style":134},[3998],{"type":66,"value":80},{"type":60,"tag":117,"props":4000,"children":4001},{"style":140},[4002],{"type":66,"value":4003}," api",{"type":60,"tag":117,"props":4005,"children":4006},{"style":140},[4007],{"type":66,"value":4008}," ls\n",{"type":60,"tag":117,"props":4010,"children":4011},{"class":119,"line":151},[4012,4016,4020,4025,4030],{"type":60,"tag":117,"props":4013,"children":4014},{"style":134},[4015],{"type":66,"value":80},{"type":60,"tag":117,"props":4017,"children":4018},{"style":140},[4019],{"type":66,"value":4003},{"type":60,"tag":117,"props":4021,"children":4022},{"style":140},[4023],{"type":66,"value":4024}," ls",{"type":60,"tag":117,"props":4026,"children":4027},{"style":140},[4028],{"type":66,"value":4029}," --filter",{"type":60,"tag":117,"props":4031,"children":4032},{"style":140},[4033],{"type":66,"value":4034}," variable\n",{"type":60,"tag":117,"props":4036,"children":4037},{"class":119,"line":161},[4038],{"type":60,"tag":117,"props":4039,"children":4040},{"emptyLinePlaceholder":155},[4041],{"type":66,"value":158},{"type":60,"tag":117,"props":4043,"children":4044},{"class":119,"line":170},[4045],{"type":60,"tag":117,"props":4046,"children":4047},{"style":124},[4048],{"type":66,"value":4049},"# Basic usage\n",{"type":60,"tag":117,"props":4051,"children":4052},{"class":119,"line":187},[4053,4057,4061],{"type":60,"tag":117,"props":4054,"children":4055},{"style":134},[4056],{"type":66,"value":80},{"type":60,"tag":117,"props":4058,"children":4059},{"style":140},[4060],{"type":66,"value":4003},{"type":60,"tag":117,"props":4062,"children":4063},{"style":140},[4064],{"type":66,"value":4065}," dags\n",{"type":60,"tag":117,"props":4067,"children":4068},{"class":119,"line":195},[4069,4073,4077,4081,4086,4091,4096,4100,4105],{"type":60,"tag":117,"props":4070,"children":4071},{"style":134},[4072],{"type":66,"value":80},{"type":60,"tag":117,"props":4074,"children":4075},{"style":140},[4076],{"type":66,"value":4003},{"type":60,"tag":117,"props":4078,"children":4079},{"style":140},[4080],{"type":66,"value":941},{"type":60,"tag":117,"props":4082,"children":4083},{"style":140},[4084],{"type":66,"value":4085}," -F",{"type":60,"tag":117,"props":4087,"children":4088},{"style":140},[4089],{"type":66,"value":4090}," limit=",{"type":60,"tag":117,"props":4092,"children":4093},{"style":3518},[4094],{"type":66,"value":4095},"10",{"type":60,"tag":117,"props":4097,"children":4098},{"style":140},[4099],{"type":66,"value":4085},{"type":60,"tag":117,"props":4101,"children":4102},{"style":140},[4103],{"type":66,"value":4104}," only_active=",{"type":60,"tag":117,"props":4106,"children":4107},{"style":471},[4108],{"type":66,"value":4109},"true\n",{"type":60,"tag":117,"props":4111,"children":4112},{"class":119,"line":204},[4113,4117,4121,4126,4131,4136,4140,4145,4150,4155,4160,4165],{"type":60,"tag":117,"props":4114,"children":4115},{"style":134},[4116],{"type":66,"value":80},{"type":60,"tag":117,"props":4118,"children":4119},{"style":140},[4120],{"type":66,"value":4003},{"type":60,"tag":117,"props":4122,"children":4123},{"style":140},[4124],{"type":66,"value":4125}," variables",{"type":60,"tag":117,"props":4127,"children":4128},{"style":140},[4129],{"type":66,"value":4130}," -X",{"type":60,"tag":117,"props":4132,"children":4133},{"style":140},[4134],{"type":66,"value":4135}," POST",{"type":60,"tag":117,"props":4137,"children":4138},{"style":140},[4139],{"type":66,"value":4085},{"type":60,"tag":117,"props":4141,"children":4142},{"style":140},[4143],{"type":66,"value":4144}," key=my_var",{"type":60,"tag":117,"props":4146,"children":4147},{"style":140},[4148],{"type":66,"value":4149}," -f",{"type":60,"tag":117,"props":4151,"children":4152},{"style":140},[4153],{"type":66,"value":4154}," value=",{"type":60,"tag":117,"props":4156,"children":4157},{"style":471},[4158],{"type":66,"value":4159},"\"",{"type":60,"tag":117,"props":4161,"children":4162},{"style":140},[4163],{"type":66,"value":4164},"my value",{"type":60,"tag":117,"props":4166,"children":4167},{"style":471},[4168],{"type":66,"value":485},{"type":60,"tag":117,"props":4170,"children":4171},{"class":119,"line":221},[4172,4176,4180,4185,4189],{"type":60,"tag":117,"props":4173,"children":4174},{"style":134},[4175],{"type":66,"value":80},{"type":60,"tag":117,"props":4177,"children":4178},{"style":140},[4179],{"type":66,"value":4003},{"type":60,"tag":117,"props":4181,"children":4182},{"style":140},[4183],{"type":66,"value":4184}," variables\u002Fold_var",{"type":60,"tag":117,"props":4186,"children":4187},{"style":140},[4188],{"type":66,"value":4130},{"type":60,"tag":117,"props":4190,"children":4191},{"style":140},[4192],{"type":66,"value":4193}," DELETE\n",{"type":60,"tag":69,"props":4195,"children":4196},{},[4197,4202,4204,4210,4212,4218],{"type":60,"tag":324,"props":4198,"children":4199},{},[4200],{"type":66,"value":4201},"Field syntax",{"type":66,"value":4203},": ",{"type":60,"tag":75,"props":4205,"children":4207},{"className":4206},[],[4208],{"type":66,"value":4209},"-F key=value",{"type":66,"value":4211}," auto-converts types, ",{"type":60,"tag":75,"props":4213,"children":4215},{"className":4214},[],[4216],{"type":66,"value":4217},"-f key=value",{"type":66,"value":4219}," keeps as string.",{"type":60,"tag":69,"props":4221,"children":4222},{},[4223,4228,4230,4235],{"type":60,"tag":324,"props":4224,"children":4225},{},[4226],{"type":66,"value":4227},"Full reference",{"type":66,"value":4229},": See ",{"type":60,"tag":96,"props":4231,"children":4233},{"href":4232},"api-reference.md",[4234],{"type":66,"value":4232},{"type":66,"value":4236}," for all options, common endpoints (XCom, event-logs, backfills), and examples.",{"type":60,"tag":84,"props":4238,"children":4240},{"id":4239},"related-skills",[4241],{"type":66,"value":4242},"Related Skills",{"type":60,"tag":999,"props":4244,"children":4245},{},[4246,4262],{"type":60,"tag":1003,"props":4247,"children":4248},{},[4249],{"type":60,"tag":1007,"props":4250,"children":4251},{},[4252,4257],{"type":60,"tag":1011,"props":4253,"children":4254},{},[4255],{"type":66,"value":4256},"Skill",{"type":60,"tag":1011,"props":4258,"children":4259},{},[4260],{"type":66,"value":4261},"Use when...",{"type":60,"tag":1027,"props":4263,"children":4264},{},[4265,4280,4295,4310,4325,4340,4355,4370,4386,4401,4416,4432],{"type":60,"tag":1007,"props":4266,"children":4267},{},[4268,4275],{"type":60,"tag":1034,"props":4269,"children":4270},{},[4271],{"type":60,"tag":324,"props":4272,"children":4273},{},[4274],{"type":66,"value":2228},{"type":60,"tag":1034,"props":4276,"children":4277},{},[4278],{"type":66,"value":4279},"Creating or editing DAG files with best practices",{"type":60,"tag":1007,"props":4281,"children":4282},{},[4283,4290],{"type":60,"tag":1034,"props":4284,"children":4285},{},[4286],{"type":60,"tag":324,"props":4287,"children":4288},{},[4289],{"type":66,"value":2308},{"type":60,"tag":1034,"props":4291,"children":4292},{},[4293],{"type":66,"value":4294},"Iterative test -> debug -> fix -> retest cycles",{"type":60,"tag":1007,"props":4296,"children":4297},{},[4298,4305],{"type":60,"tag":1034,"props":4299,"children":4300},{},[4301],{"type":60,"tag":324,"props":4302,"children":4303},{},[4304],{"type":66,"value":2348},{"type":60,"tag":1034,"props":4306,"children":4307},{},[4308],{"type":66,"value":4309},"Deep root cause analysis and failure diagnosis",{"type":60,"tag":1007,"props":4311,"children":4312},{},[4313,4320],{"type":60,"tag":1034,"props":4314,"children":4315},{},[4316],{"type":60,"tag":324,"props":4317,"children":4318},{},[4319],{"type":66,"value":2368},{"type":60,"tag":1034,"props":4321,"children":4322},{},[4323],{"type":66,"value":4324},"Checking if data is up to date or stale",{"type":60,"tag":1007,"props":4326,"children":4327},{},[4328,4335],{"type":60,"tag":1034,"props":4329,"children":4330},{},[4331],{"type":60,"tag":324,"props":4332,"children":4333},{},[4334],{"type":66,"value":2379},{"type":60,"tag":1034,"props":4336,"children":4337},{},[4338],{"type":66,"value":4339},"Finding where data comes from",{"type":60,"tag":1007,"props":4341,"children":4342},{},[4343,4350],{"type":60,"tag":1034,"props":4344,"children":4345},{},[4346],{"type":60,"tag":324,"props":4347,"children":4348},{},[4349],{"type":66,"value":2390},{"type":60,"tag":1034,"props":4351,"children":4352},{},[4353],{"type":66,"value":4354},"Impact analysis -- what breaks if something changes",{"type":60,"tag":1007,"props":4356,"children":4357},{},[4358,4365],{"type":60,"tag":1034,"props":4359,"children":4360},{},[4361],{"type":60,"tag":324,"props":4362,"children":4363},{},[4364],{"type":66,"value":366},{"type":60,"tag":1034,"props":4366,"children":4367},{},[4368],{"type":66,"value":4369},"Deploying DAGs to production (Astro, Docker Compose, Kubernetes)",{"type":60,"tag":1007,"props":4371,"children":4372},{},[4373,4381],{"type":60,"tag":1034,"props":4374,"children":4375},{},[4376],{"type":60,"tag":324,"props":4377,"children":4378},{},[4379],{"type":66,"value":4380},"migrating-airflow-2-to-3",{"type":60,"tag":1034,"props":4382,"children":4383},{},[4384],{"type":66,"value":4385},"Upgrading DAGs from Airflow 2.x to 3.x",{"type":60,"tag":1007,"props":4387,"children":4388},{},[4389,4396],{"type":60,"tag":1034,"props":4390,"children":4391},{},[4392],{"type":60,"tag":324,"props":4393,"children":4394},{},[4395],{"type":66,"value":351},{"type":60,"tag":1034,"props":4397,"children":4398},{},[4399],{"type":66,"value":4400},"Starting, stopping, or troubleshooting local Airflow",{"type":60,"tag":1007,"props":4402,"children":4403},{},[4404,4411],{"type":60,"tag":1034,"props":4405,"children":4406},{},[4407],{"type":60,"tag":324,"props":4408,"children":4409},{},[4410],{"type":66,"value":335},{"type":60,"tag":1034,"props":4412,"children":4413},{},[4414],{"type":66,"value":4415},"Initializing a new Astro\u002FAirflow project",{"type":60,"tag":1007,"props":4417,"children":4418},{},[4419,4427],{"type":60,"tag":1034,"props":4420,"children":4421},{},[4422],{"type":60,"tag":324,"props":4423,"children":4424},{},[4425],{"type":66,"value":4426},"airflow-state-store",{"type":60,"tag":1034,"props":4428,"children":4429},{},[4430],{"type":66,"value":4431},"Per-task checkpointing, watermarks, crash-safe operators (Airflow 3.3+)",{"type":60,"tag":1007,"props":4433,"children":4434},{},[4435,4443],{"type":60,"tag":1034,"props":4436,"children":4437},{},[4438],{"type":60,"tag":324,"props":4439,"children":4440},{},[4441],{"type":66,"value":4442},"airflow-hitl",{"type":60,"tag":1034,"props":4444,"children":4445},{},[4446],{"type":66,"value":4447},"Pausing a DAG for human approval or input (Airflow 3.1+)",{"type":60,"tag":4449,"props":4450,"children":4451},"style",{},[4452],{"type":66,"value":4453},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":4455,"total":4546},[4456,4463,4474,4491,4504,4521,4534],{"slug":4,"name":4,"fn":5,"description":6,"org":4457,"tags":4458,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4459,4460,4461,4462],{"name":13,"slug":4,"type":14},{"name":19,"slug":20,"type":14},{"name":16,"slug":17,"type":14},{"name":22,"slug":23,"type":14},{"slug":4442,"name":4442,"fn":4464,"description":4465,"org":4466,"tags":4467,"stars":24,"repoUrl":25,"updatedAt":4473},"add human-in-the-loop steps to Airflow DAGs","Builds human-in-the-loop (HITL) Airflow workflows - approval gates, form input, and human-driven branching. Use when a DAG needs a human in the loop - an approval or reject step, sign-off before a task runs, a decision or approval UI, branching on a human choice, or collecting form input mid-run; also on mentions of ApprovalOperator, HITLOperator, HITLBranchOperator, HITLEntryOperator, or HITLTrigger. Requires Airflow 3.1+. Not for AI\u002FLLM task calls (see migrating-ai-sdk-to-common-ai).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4468,4469,4472],{"name":13,"slug":4,"type":14},{"name":4470,"slug":4471,"type":14},"Approvals","approvals",{"name":16,"slug":17,"type":14},"2026-04-06T18:01:46.758548",{"slug":4475,"name":4475,"fn":4476,"description":4477,"org":4478,"tags":4479,"stars":24,"repoUrl":25,"updatedAt":4490},"airflow-plugins","build Airflow UI plugins","Builds Airflow 3.1+ plugins that embed FastAPI apps, custom UI pages, React components, middleware, macros, and operator links directly into the Airflow UI. Use when building anything custom inside Airflow 3.1+ that involves Python and a browser-facing interface - creating an Airflow plugin, adding a custom UI page or nav entry, building FastAPI-backed endpoints inside Airflow, serving static assets from a plugin, embedding a React app, adding middleware to the API server, creating custom operator extra links, or calling the Airflow REST API from inside a plugin; also when AirflowPlugin, fastapi_apps, external_views, react_apps, or plugin registration come up.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4480,4481,4484,4487],{"name":13,"slug":4,"type":14},{"name":4482,"slug":4483,"type":14},"Plugin Development","plugin-development",{"name":4485,"slug":4486,"type":14},"Python","python",{"name":4488,"slug":4489,"type":14},"UI Components","ui-components","2026-04-06T18:01:56.827891",{"slug":4426,"name":4426,"fn":4492,"description":4493,"org":4494,"tags":4495,"stars":24,"repoUrl":25,"updatedAt":4503},"persist Airflow task and asset state","Persists task and asset state across retries and DAG runs using Airflow 3.3's AIP-103 key\u002Fvalue stores (`task_state_store`, `asset_state_store`) and the crash-safe `ResumableJobMixin`. Use when the user asks about task state store, checkpointing in tasks, persisting state across retries, job IDs surviving worker crashes, watermarks, asset metadata, resumable tasks, crash-safe operators, or \"what's new in Airflow 3.3\". Also use proactively when reading a DAG that uses Variables or XCom for intra-task coordination state — flag the anti-pattern and recommend task_state_store or asset_state_store instead. Requires Airflow 3.3+.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4496,4497,4499,4500],{"name":13,"slug":4,"type":14},{"name":4498,"slug":38,"type":14},"Data Engineering",{"name":16,"slug":17,"type":14},{"name":4501,"slug":4502,"type":14},"Operations","operations","2026-07-07T06:43:11.160671",{"slug":4505,"name":4505,"fn":4506,"description":4507,"org":4508,"tags":4509,"stars":24,"repoUrl":25,"updatedAt":4520},"analyzing-data","query data warehouses for business questions","Queries the data warehouse with SQL and answers business questions about data. Use when answering anything that needs warehouse data - counts, metrics, trends, aggregations, joins across tables, data lookups, or ad-hoc SQL analysis (for example \"who uses X\", \"how many Y\", \"show me Z\", \"find customers\", \"what is the count\").",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4510,4513,4516,4517],{"name":4511,"slug":4512,"type":14},"Analytics","analytics",{"name":4514,"slug":4515,"type":14},"Data Analysis","data-analysis",{"name":4498,"slug":38,"type":14},{"name":4518,"slug":4519,"type":14},"SQL","sql","2026-04-06T18:01:49.599775",{"slug":4522,"name":4522,"fn":4523,"description":4524,"org":4525,"tags":4526,"stars":24,"repoUrl":25,"updatedAt":4533},"annotating-task-lineage","annotate Airflow tasks with data lineage","Annotate Airflow tasks with data lineage using inlets and outlets. Use when the user wants to add lineage metadata to tasks, specify input\u002Foutput datasets, or enable lineage tracking for operators without built-in OpenLineage extraction.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4527,4528,4529,4530],{"name":13,"slug":4,"type":14},{"name":4498,"slug":38,"type":14},{"name":16,"slug":17,"type":14},{"name":4531,"slug":4532,"type":14},"Observability","observability","2026-04-06T18:02:03.487365",{"slug":2228,"name":2228,"fn":4535,"description":4536,"org":4537,"tags":4538,"stars":24,"repoUrl":25,"updatedAt":4545},"author Airflow DAGs","Workflow and best practices for writing Apache Airflow DAGs. Use when creating a new DAG, write pipeline code, handling questions about DAG patterns and conventions or extending an existing DAG with a follow-up\u002Fdownstream task. ANY request shaped like 'add a DAG named X', 'write a pipeline', 'add a task that runs after Y', or 'extend the DAG'. For testing and debugging DAGs, see the testing-dags skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4539,4540,4541,4544],{"name":13,"slug":4,"type":14},{"name":16,"slug":17,"type":14},{"name":4542,"slug":4543,"type":14},"ETL","etl",{"name":4485,"slug":4486,"type":14},"2026-04-06T18:01:52.679888",34,{"items":4548,"total":4546},[4549,4556,4562,4569,4576,4583,4590,4597,4612,4626,4636,4649],{"slug":4,"name":4,"fn":5,"description":6,"org":4550,"tags":4551,"stars":24,"repoUrl":25,"updatedAt":26},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4552,4553,4554,4555],{"name":13,"slug":4,"type":14},{"name":19,"slug":20,"type":14},{"name":16,"slug":17,"type":14},{"name":22,"slug":23,"type":14},{"slug":4442,"name":4442,"fn":4464,"description":4465,"org":4557,"tags":4558,"stars":24,"repoUrl":25,"updatedAt":4473},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4559,4560,4561],{"name":13,"slug":4,"type":14},{"name":4470,"slug":4471,"type":14},{"name":16,"slug":17,"type":14},{"slug":4475,"name":4475,"fn":4476,"description":4477,"org":4563,"tags":4564,"stars":24,"repoUrl":25,"updatedAt":4490},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4565,4566,4567,4568],{"name":13,"slug":4,"type":14},{"name":4482,"slug":4483,"type":14},{"name":4485,"slug":4486,"type":14},{"name":4488,"slug":4489,"type":14},{"slug":4426,"name":4426,"fn":4492,"description":4493,"org":4570,"tags":4571,"stars":24,"repoUrl":25,"updatedAt":4503},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4572,4573,4574,4575],{"name":13,"slug":4,"type":14},{"name":4498,"slug":38,"type":14},{"name":16,"slug":17,"type":14},{"name":4501,"slug":4502,"type":14},{"slug":4505,"name":4505,"fn":4506,"description":4507,"org":4577,"tags":4578,"stars":24,"repoUrl":25,"updatedAt":4520},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4579,4580,4581,4582],{"name":4511,"slug":4512,"type":14},{"name":4514,"slug":4515,"type":14},{"name":4498,"slug":38,"type":14},{"name":4518,"slug":4519,"type":14},{"slug":4522,"name":4522,"fn":4523,"description":4524,"org":4584,"tags":4585,"stars":24,"repoUrl":25,"updatedAt":4533},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4586,4587,4588,4589],{"name":13,"slug":4,"type":14},{"name":4498,"slug":38,"type":14},{"name":16,"slug":17,"type":14},{"name":4531,"slug":4532,"type":14},{"slug":2228,"name":2228,"fn":4535,"description":4536,"org":4591,"tags":4592,"stars":24,"repoUrl":25,"updatedAt":4545},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4593,4594,4595,4596],{"name":13,"slug":4,"type":14},{"name":16,"slug":17,"type":14},{"name":4542,"slug":4543,"type":14},{"name":4485,"slug":4486,"type":14},{"slug":4598,"name":4598,"fn":4599,"description":4600,"org":4601,"tags":4602,"stars":24,"repoUrl":25,"updatedAt":4611},"authoring-go-sdk-tasks","implement Airflow tasks in Go","Writes Airflow task logic in Go using the Airflow Go SDK. Use when the user wants to implement Airflow tasks in Go, asks about `BundleProvider`\u002F`RegisterDags`, the `bundlev1` Registry\u002FDag interfaces, registering Go tasks (`AddTask`\u002F`AddTaskWithName`), dependency injection by parameter type (`context.Context`, `sdk.TIRunContext`, `*slog.Logger`, `sdk.Client`), or reading connections\u002Fvariables\u002FXComs from Go. This skill covers the Go-specific native API; the shared Python-stub pattern and conceptual model live in authoring-language-sdk-tasks. For building\u002Fpacking\u002Fshipping the bundle see deploying-go-sdk-bundles; for coordinator config see configuring-airflow-language-sdks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4603,4604,4607,4608],{"name":13,"slug":4,"type":14},{"name":4605,"slug":4606,"type":14},"API Development","api-development",{"name":16,"slug":17,"type":14},{"name":4609,"slug":4610,"type":14},"Go","go","2026-07-11T05:39:13.552213",{"slug":4613,"name":4613,"fn":4614,"description":4615,"org":4616,"tags":4617,"stars":24,"repoUrl":25,"updatedAt":4625},"authoring-java-sdk-tasks","implement Airflow tasks in Java","Writes Airflow task logic in Java, Kotlin, or any JVM language using the Airflow Java SDK. Use when the user wants to implement Airflow tasks in Java\u002FJVM, asks about `@Builder.Dag`\u002F`@Builder.Task`\u002F`@Builder.XCom`, the `Task`\u002F`BundleBuilder` interfaces, reading connections\u002Fvariables\u002FXComs from Java, the JSON-to-Java type mapping, or logging from Java tasks. This skill covers the Java-specific native API; the shared Python-stub pattern and conceptual model live in authoring-language-sdk-tasks. For building\u002Fshipping the bundle see deploying-java-sdk-bundles; for coordinator config see configuring-airflow-language-sdks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4618,4619,4622],{"name":16,"slug":17,"type":14},{"name":4620,"slug":4621,"type":14},"Engineering","engineering",{"name":4623,"slug":4624,"type":14},"Java","java","2026-07-18T05:48:13.374003",{"slug":4627,"name":4627,"fn":4628,"description":4629,"org":4630,"tags":4631,"stars":24,"repoUrl":25,"updatedAt":4635},"authoring-language-sdk-tasks","implement non-Python Airflow tasks","The language-neutral foundation for Airflow language SDKs — implement task logic in a non-Python language while the DAG stays in Python. Use when the user wants to run an Airflow task in another language (Java, Kotlin, Go, or other JVM\u002Fnative languages), asks how the Python `@task.stub` pairs with native task code, how task\u002FDAG IDs must match across the two sides, how data passes via XCom as JSON, or which language SDKs exist. This skill owns the shared Python-stub pattern and conceptual model; for a specific language's native API, build, and runtime, use that language's skill (e.g. authoring-java-sdk-tasks, authoring-go-sdk-tasks).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4632,4633,4634],{"name":13,"slug":4,"type":14},{"name":16,"slug":17,"type":14},{"name":4620,"slug":4621,"type":14},"2026-07-18T05:11:54.496539",{"slug":4637,"name":4637,"fn":4638,"description":4639,"org":4640,"tags":4641,"stars":24,"repoUrl":25,"updatedAt":4648},"blueprint","build reusable Airflow task group templates","Define reusable Airflow task group templates with Pydantic validation and compose DAGs from YAML. Use when creating blueprint templates, composing DAGs from YAML, validating configurations, or enabling no-code DAG authoring for non-engineers.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4642,4643,4644,4645],{"name":13,"slug":4,"type":14},{"name":16,"slug":17,"type":14},{"name":4542,"slug":4543,"type":14},{"name":4646,"slug":4647,"type":14},"Templates","templates","2026-04-06T18:01:45.361425",{"slug":2368,"name":2368,"fn":4650,"description":4651,"org":4652,"tags":4653,"stars":24,"repoUrl":25,"updatedAt":4660},"check data freshness in warehouses","Quick data freshness check. Use when the user asks if data is up to date, when a table was last updated, if data is stale, or needs to verify data currency before using it.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4654,4655,4656,4659],{"name":13,"slug":4,"type":14},{"name":4498,"slug":38,"type":14},{"name":4657,"slug":4658,"type":14},"Data Quality","data-quality",{"name":4542,"slug":4543,"type":14},"2026-04-06T18:02:02.138565"]