# air-verse/air

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/air-verse-air).**

22,999 stars · 906 forks · Go · gpl-3.0

## Links

- GitHub: https://github.com/air-verse/air
- awesome-repositories: https://awesome-repositories.com/repository/air-verse-air.md

## Topics

`docker` `file-watcher` `gin` `go` `live-reload` `task-runner` `tools` `watcher`

## Description

Air is a command-line utility designed to automate the development lifecycle for Go applications. It functions as a build runner that monitors source code for file-system modifications, automatically triggering rebuilds and process restarts to maintain an updated development environment.

The tool distinguishes itself by integrating container-isolated execution, allowing developers to run build and test workflows within consistent, ephemeral environments. It also incorporates a reverse-proxy layer that intercepts network traffic to facilitate live-reloading of browser sessions, ensuring that changes to static content or templates are reflected immediately without manual intervention.

Beyond its core reload capabilities, the project provides a configuration-driven framework for managing complex build pipelines. Users can define custom entrypoints, environment variables, and platform-specific overrides to standardize compilation and execution tasks across different host machines.

## Tags

### Development Tools & Productivity

- [Live Reloading Tools](https://awesome-repositories.com/f/development-tools-productivity/live-reloading-tools.md) — Monitors source code for changes and automatically triggers rebuilds and restarts for Go applications. ([source](https://cdn.jsdelivr.net/gh/air-verse/air@master/README.md))
- [Build Task Runners](https://awesome-repositories.com/f/development-tools-productivity/build-tooling/build-orchestration-logic/build-orchestration-configuration/build-lifecycle-orchestrators/build-task-runners.md) — Executes automated build, maintenance, and lifecycle commands defined in project configurations.
- [Containerized Development Environments](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/development-environments/isolated-execution-environments/containerized-development-environments.md) — Manages build and test workflows within isolated container environments to ensure consistent behavior.
- [Hot-Reloading Systems](https://awesome-repositories.com/f/development-tools-productivity/hot-reloading-systems.md) — Enables iterating on code while it runs, with edits reflected immediately without losing application state.
- [Build Automation](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/build-task-automation/build-automation.md) — Automates the compilation and preparation of software through custom build commands and environment variables.
- [Isolated Execution Environments](https://awesome-repositories.com/f/development-tools-productivity/isolated-execution-environments.md) — Encapsulates development workflows within ephemeral, isolated environments to ensure consistent runtime behavior.
- [Build Configurations](https://awesome-repositories.com/f/development-tools-productivity/build-tooling/build-orchestration-logic/build-orchestration-configuration/build-configuration-systems/build-configurations.md) — Defines parameters, dependencies, and environment variables for controlling software build processes. ([source](https://cdn.jsdelivr.net/gh/air-verse/air@master/README.md))
- [Process Lifecycle Managers](https://awesome-repositories.com/f/development-tools-productivity/process-lifecycle-managers.md) — Manages the startup, monitoring, and graceful termination of application processes during development.
- [Build Environment Configurations](https://awesome-repositories.com/f/development-tools-productivity/project-scaffolding-config-code-generation/project-scaffolding-configuration/build-configuration/build-environment-configurations.md) — Provides configuration settings for defining build modes and environment variables to control compilation behavior.
- [Build Triggers](https://awesome-repositories.com/f/development-tools-productivity/working-directory-configuration/directory-change-trackers/build-triggers.md) — Triggers application rebuilds and restarts automatically when source code files are modified. ([source](https://github.com/air-verse/air/tree/master/docs/))

### Web Development

- [Live-Reload Proxies](https://awesome-repositories.com/f/web-development/static-file-servers/live-reload-proxies.md) — Routes traffic and triggers automatic browser refreshes when static files or templates are modified.

### DevOps & Infrastructure

- [Container Isolation Technologies](https://awesome-repositories.com/f/devops-infrastructure/container-isolation-technologies.md) — Executes development workflows within isolated container environments to ensure consistent behavior. ([source](https://cdn.jsdelivr.net/gh/air-verse/air@master/README.md))

### Networking & Communication

- [Local Reverse Proxies](https://awesome-repositories.com/f/networking-communication/local-reverse-proxies.md) — Intercepts and routes local network traffic to inject live-reload signals into browser sessions.

### System Administration & Monitoring

- [File System Watchers](https://awesome-repositories.com/f/system-administration-monitoring/file-system-watchers.md) — Monitors directory trees for file system modifications to trigger automated build tasks.