Download for macOS
Skill

managing-astro-local-env

@astronomer Updated 2026-10-14

Manage local Airflow environment with Astro CLI (Docker and standalone modes). Use when the user wants to start, stop, or restart Airflow, view logs, query the Airflow API, troubleshoot, or fix environment issues. For project setup, see setting-up-astro-project.

agentic-workflowagentsaiai-agentsairflowapache-airflowclaudecursor

Install

git clone https://github.com/astronomer/agents /tmp/agents && ln -s /tmp/agents/skills/managing-astro-local-env ~/.claude/skills/managing-astro-local-env

From README

Astro Local Environment This skill helps you manage your local Airflow environment using the Astro CLI. Two modes: Docker (default, uses containers) and Standalone (Docker-free, uses a local venv — requires Airflow 3 + uv). To set up a new project, see the setting-up-astro-project skill. When Airflow is running, use MCP tools from authoring-dags and testing-dags skills. --- Start / Stop / Restart (Docker) Default credentials: admin / admin Restart after modifying: requirements.txt, packages.txt, Dockerfile Standalone mode? See the next section. --- Standalone Mode Docker-free local development. Runs Airflow directly on your machine in a .venv/ managed by uv. Requirements: Airflow 3 (runtime 3.x), uv on PATH. Not supported on Windows. Plain astro dev init already pins a runtime 3.x image, so no version flag is needed. See setting-up-astro-project for project initialization.