astro-cli

Manage Astronomer Astro projects, local Airflow environments, and cloud deployments via CLI commands.

3|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill astro-cli
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: astro-cli
Source: https://github.com/Cogni-AI-OU/cogni-ai-agent-skills/tree/main/astro-cli
Command: npx skills add https://github.com/Cogni-AI-OU/cogni-ai-agent-skills --skill astro-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you operate Astro CLI workflows for Astronomer projects without getting stuck on local-vs-cloud differences, authentication, or Airflow API usage.

Core Features & Use Cases

  • Astro project lifecycle management: Initialize, validate, start, stop, parse, and run tests for both Docker and Standalone local modes (e.g., keeping DAGs import-safe).
  • Connections, variables, and environment portability: Export/import Airflow connections and variables to move runtime configuration between environments.
  • Cloud deployment operations and REST API access: Switch workspaces, inspect/create/deploy deployments, view component-scoped logs, and call Airflow REST endpoints through the authenticated astro api airflow wrapper.

Quick Start

Use the astro-cli skill to start a local Airflow environment by running the command: astro dev start --standalone.

Frequently Asked Questions about astro-cli

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

FAQPage Schema
How do I start a local Airflow environment using Astro CLI?ā–¼

Start a local Airflow environment by running the astro dev start command, which supports both Docker and Standalone modes for initializing and running your Astro project locally.

How do I call the Airflow REST API in an Astro project?ā–¼

Call the Airflow REST API in an Astro project by authenticating with astro login and executing astro api airflow to perform endpoint operations within the current Astro context.

Can I export and import Airflow connections and variables between environments?ā–¼

Export and import Airflow connections and variables to move runtime configuration between local and cloud deployments, ensuring environment portability for your Astro project.

What is the best way to validate DAGs before deploying to an Astronomer cloud deployment?ā–¼

Validate DAGs before cloud deployment by using the Astro CLI to parse and run tests locally, keeping DAGs import-safe, and then inspecting and creating deployments for cloud operations.

Does Astro CLI support troubleshooting deployment logs for specific components?ā–¼

Astro CLI supports troubleshooting deployment logs by allowing you to view component-scoped logs, inspect existing deployments, and switch workspaces for targeted cloud deployment operations.