Dear Airflow Community,
I am excited to announce the availability of airflowctl 1.0.0b1 for testing! This marks the very first beta release of airflowctl, a new command-line companion tool designed to simplify interaction with the Apache Airflow API and provide a modern, consistent interface for daily Airflow operations. First, a few caveats: This is a beta release, so do not run it in production. It may contain significant issues, and breaking changes may occur before the final 1.0.0 release. (Consider yourself warned!) This release is intended for Airflow developers and early adopters to test the build and start preparing for airflowctl 1.0.0. This is not an official release—that will happen when we create a release candidate and hold a vote. The expected timeline for the first release candidate is the week of 2025-09-08, but we encourage early feedback to help stabilise the release. What's new in airflowctl? airflowctl 1.0.0 beta1 introduces the initial implementation of the CLI tool that only securely communicates with the API, bringing modernised workflows for interacting with Airflow’s API and managing your environments. Notable Features Unified CLI-API Interface airflowctl provides a streamlined interface to interact with the Airflow API, enabling consistent management of deployments, tasks, and operations. It bridges the gap between the Airflow web UI and CLI, giving users a more scriptable and automation-friendly way of working. Authentication & Environment Management airflowctl introduces environment-aware configuration, allowing users to manage multiple Airflow instances easily. With simple login commands, credentials and tokens can be stored and switched across environments. airflowctl stores passwords in keyrings; natively, they are in a secure place. Modern User Experience airflowctl has been designed with ease of use in mind: - Unified commands and flags for discoverability. - Built-in `--help` system to guide usage. - Clear error messages and feedback loops for faster debugging - Using the same Pydantic models with the API to unify parameter names and flags. For a more comprehensive list of features, please see, - 1.0.0b1 Documentation(for preview): https://airflow.staged.apache.org/docs/apache-airflow-ctl/1.0.0b1 - 1.0.0b1 Release Notes: https://github.com/apache/airflow/blob/airflow-ctl/1.0.0b1/airflow-ctl/RELEASE_NOTES.rst Known limitations in 1.0.0.b1: - Some Airflow API endpoints and airflow CLI functionalities are not yet fully supported. Where to get it? The beta snapshot is available at: https://dist.apache.org/repos/dist/dev/airflow/airflow-ctl/1.0.0b1/ - apache-airflow-ctl-1.0.0b1-bin.tar.gz: Binary Python "sdist" snapshot. - apache-airflow-ctl-1.0.0b1-py3-none-any.whl: Binary Python wheel snapshot. This snapshot has also been published to PyPI as well and you can install it using: pip install apache-airflow-ctl==1.0.0b1 Public Keys & Verification Public keys for verification are available at: https://www.apache.org/dist/airflow/KEYS Instructions: You can install this beta into a virtualenv like this using uv: uv venv uv pip install apache-airflow-ctl==1.0.0b1 Get Involved We encourage the community to test this release and report any issues or feedback. Your contributions help us ensure a stable and reliable airflowctl 1.0.0 release. Please report issues using GitHub at https://github.com/apache/airflow/issues and mark that this is an issue in 1.0.0. For an updated list of all known issues in the beta, please visit the above link with the label “area:airflow-ctl”. A huge thank you to all the contributors who have worked to bring airflowctl to life! Thanks, Jarek & Bugra
