Get swag on macOS and Linux Now!
Automatically generate RESTful API documentation with Swagger 2.0 for Go
Get swag with one command
Pick your system, reveal the step-by-step guide, copy the command, paste it into your terminal and press Enter. This command comes from the project's public source.
Not available for Windows yet.
swag doesn't publish an install command for Windows anywhere we can verify, so there's nothing for us to show you. We won't invent one. It does document one for macOS and Linux — switch to that tab.
Pastes into PowerShell and installs swag on your Windows machine in one step. Runs as your normal user account, and needs no administrator rights.
Not available for macOS yet.
swag doesn't publish an install command for macOS or Linux anywhere we can verify, so there's nothing for us to show you. We won't invent one.
Installs swag on your macOS or Linux machine and links it into your PATH — after this,
swag just works from any directory. Runs as your normal user account, and needs no administrator rights.
How to set up swag, step by step
Open Terminal. On a Mac it's in Applications ▸ Utilities, or press Cmd+Space and type Terminal. On Linux, press Ctrl+Alt+T. Paste the command and press Enter.
Run swag --help to see the available commands, and
swag --version to confirm the install worked. If your shell complains about
permissions, that project usually documents a corrected command on its own site.
This asks Homebrew to fetch swag and link it into /opt/homebrew/bin (Apple Silicon) or /usr/local/bin (Intel), so you can run it by name.
swag at a glance
- Installs with a single
command —
Homebrew. - Installs on macOS / Linux.
- Free and open source, with no paid tier and no account needed.
- 13k stars — an actively used project.
swag doesn't publish a feature list we can quote, so this is what we verified ourselves.
About swag
Automatically generate RESTful API documentation with Swagger 2.0 for Go
| Category | Developer tool |
|---|---|
| Install method | Homebrew |
| Windows | no install command published |
| macOS / Linux | documented install command available |
| Price | Free and open source |
| Command verified | From project source |
| Popularity | 13k stars on the project's public repository |
On mobile
swag is a command-line tool, so there is no phone app for it — a phone has no shell to run it in. You'll need a desktop, or a remote shell into a machine that has one.
swag is developed by its own authors. This page is an independent reference; we are not affiliated with or sponsored by the project. The command shown here was reproduced from the project's public documentation — always check the project's own documentation before running anything.