explaingit

air-verse/air

Analysis updated 2026-06-21

23,493GoAudience · developerComplexity · 2/5Setup · easy

TLDR

Air is a live-reload development tool for Go that automatically rebuilds and restarts your program every time you save a file, eliminating the manual stop-compile-restart loop.

Mindmap

mindmap
  root((repo))
    What it does
      Auto-rebuild on save
      Auto-restart server
      Watch file changes
    Configuration
      TOML config file
      Custom build command
      Ignore directories
    Use Cases
      Go web development
      Gin framework projects
      Docker development
    Audience
      Go developers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a Go web server with automatic restarts on every file save during development.

USE CASE 2

Configure custom watch paths and build commands per project using a TOML config file.

USE CASE 3

Speed up iteration on a Gin-based API by letting Air handle rebuilds while you focus on code.

What is it built with?

Go

How does it compare?

air-verse/aircharmbracelet/gumquii/learn-go-with-tests
Stars23,49323,56223,627
LanguageGoGoGo
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

In plain English

Air is a live-reload tool for Go applications. The problem it solves is a tedious development loop: when you change your Go code, you normally have to stop the running program, recompile it, and restart it manually before you can see the effect. Air automates all of that, you run it once in your project folder, and whenever you save a file, it automatically rebuilds your program and restarts it in the background. You just run the "air" command in your project directory, and it watches for file changes. When it detects one, it runs your build command (typically "go build"), and if the build succeeds, it kills the old process and starts the new one. Configuration is done through a TOML file where you can customize which directories to watch, which to ignore, what build command to run, and how to pass arguments to the resulting binary. It also supports loading environment variables from .env files before each build, and it can run inside Docker containers. You would use this during Go development whenever you are iterating quickly on code and don't want to manually restart your server or application after every change. It is especially common when building web servers with frameworks like Gin. It is strictly a development tool and is not meant for production deployments. The tool is written in Go.

Copy-paste prompts

Prompt 1
I'm building a Go web server with Gin. Show me how to install Air and configure it to watch my project, ignore the vendor folder, and restart on any .go file change.
Prompt 2
Generate a .air.toml config for a Go project that uses go build -o ./tmp/main ./cmd/server and passes --env=dev as an argument to the binary.
Prompt 3
I want to use Air inside Docker during development. Show me the Dockerfile and air.toml setup so the container auto-reloads when I edit files on my host machine.
Prompt 4
Air rebuilt my Go binary but the new process isn't starting, walk me through debugging by reading the Air build log output.

Frequently asked questions

What is air?

Air is a live-reload development tool for Go that automatically rebuilds and restarts your program every time you save a file, eliminating the manual stop-compile-restart loop.

What language is air written in?

Mainly Go. The stack also includes Go.

How hard is air to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is air for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub air-verse on gitmyhub

Verify against the repo before relying on details.