For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Astro CLI
    • Quickstart
    • CLI reference
      • astro completion
      • astro config
      • astro context
      • astro dbt
      • astro deploy
      • astro deployment
      • astro dev
      • astro ide
      • astro login
      • astro logout
      • astro organization
      • astro remote
      • astro run
      • astro team
      • astro registry
        • astro registry dag add
        • astro registry provider add
      • astro user create
      • astro version
      • astro workspace

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
CLI referenceastro registry

astro registry dag add

Built with
The behavior and format of this command are the same for both Astro and Astro Private Cloud.

Download a dag from the Astronomer Registry to your Astro project.

Usage

1astro registry dag add

When you run the command, the CLI prompts you for a dag ID to download. To retrieve the dag name, open the dag in the Astronomer registry and copy the URL between dags/ and /versions. For example, in the URL https://registry.astronomer.io/dags/upload_files_to_s3/versions/1.0.0, copy upload_files_to_s3.

Options

OptionDescriptionValid Values
<dag-id>The dag ID to download.Any valid dag ID. Must be the first option in the command.
--versionThe version of the dag to download.Any valid version.
--add-providersAttempt to add the required providers for the dag to requirements.txt.None.

Examples

1# Download version 1.0.0 of a dag called 'upload_files_to_s3'
2astro registry dag add upload_files_to_s3 --version 1.0.0

Related commands

  • astro registry provider add
  • astro dev start