air

# :cloud: Air - Live reload for Go apps

[![Release](https://img.shields.io/github/v/release/air-verse/air?sort=semver)](https://github.com/air-verse/air/releases)
[![Go Version](https://img.shields.io/github/go-mod/go-version/air-verse/air)](https://github.com/air-verse/air/blob/master/go.mod)
[![Downloads](https://img.shields.io/github/downloads/air-verse/air/total)](https://github.com/air-verse/air/releases)
[![Docker Pulls](https://img.shields.io/docker/pulls/cosmtrek/air)](https://hub.docker.com/r/cosmtrek/air)
[![Go](https://github.com/air-verse/air/actions/workflows/release.yml/badge.svg)](https://github.com/air-verse/air/actions?query=workflow%3AGo+branch%3Amaster)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/dcb95264cc504cad9c2a3d8b0795a7f8)](https://www.codacy.com/gh/air-verse/air/dashboard?utm_source=github.com&utm_medium=referral&utm_content=air-verse/air&utm_campaign=Badge_Grade)
[![codecov](https://codecov.io/gh/air-verse/air/branch/master/graph/badge.svg)](https://codecov.io/gh/air-verse/air)

English | [简体中文](README-zh_cn.md) | [繁體中文](README-zh_tw.md) | [日本語](README-ja.md)

Air is a live-reloading command line utility for developing Go applications. Run `air` in your project root directory, leave it alone, and focus on your code. Note that this tool has nothing to do with hot-deploy for production.

![air](docs/air.png)

## Contents

- [Air - Live reload for Go apps](#cloud-air---live-reload-for-go-apps)
  - [Contents](#contents)
  - [Installation](#installation)
    - [Via `go install` (recommended)](#via-go-install-recommended)
    - [Via `go get -tool` (project install)](#via-go-get--tool-project-install)
    - [Via install.sh](#via-installsh)
    - [Via goblin.run](#via-goblinrun)
    - [Via Homebrew](#via-homebrew)
    - [Via Scoop](#via-scoop)
    - [Via mise](#via-mise)
    - [Via Docker/Podman](#via-dockerpodman)
  - [Quick start](#quick-start)
  - [Features](#features)
  - [Usage](#usage)
    - [Runtime arguments](#runtime-arguments)
    - [Debug](#debug)
  - [Configuration](#configuration)
    - [Overwrite specific configuration from arguments](#overwrite-specific-configuration-from-arguments)
    - [Startup banner](#startup-banner)
    - [Entrypoint](#entrypoint)
    - [Environment files](#environment-files)
    - [Platform-specific build overrides](#platform-specific-build-overrides)
    - [Watch rules: run a command instead of rebuilding](#watch-rules-run-a-command-instead-of-rebuilding)
    - [Proxy: reload the browser automatically](#proxy-reload-the-browser-automatically)
  - [Docker](#docker)
    - [Using the official image](#using-the-official-image)
    - [Shell function](#shell-function)
    - [Docker Compose](#docker-compose)
    - [Without the air image](#without-the-air-image)
  - [Q&A](#qa)
    - [command not found: air](#command-not-found-air)
    - [Error under WSL when the bin path contains a single quote](#error-under-wsl-when-the-bin-path-contains-a-single-quote)
    - [How to do hot com