# flyctl

> Command-line interface for fly.io that authenticates accounts, lists apps, and checks app status; also invoked as fly.

Stars: 1.7k · Language: Go · License: Apache-2.0 · Categories: Dev Tools

- Repository: https://github.com/superfly/flyctl
- Website: https://fly.io
- Page: https://www.trmn.sh/tools/flyctl

## Install

- Homebrew: `brew install flyctl`
- Install script (macOS, Linux, WSL): `curl -L https://fly.io/install.sh | sh`
- PowerShell (Windows): `iwr https://fly.io/install.ps1 -useb | iex`

## Overview

flyctl is the official command-line interface for fly.io. It is used to sign in to a Fly account and manage apps running on the platform from the terminal. Most installations also alias the binary to `fly`, which is planned to become the default command name, so `flyctl` and `fly` can be used interchangeably in commands.

The README documents a basic workflow: `fly auth login` to authenticate, `fly apps list` to list your apps, and `fly status -a {app-name}` to view an app's status. For app targeting, flyctl reads the app name from a `fly.toml` file in the current directory. It operates on that app unless you override it with the `-a` flag or another app name setting on the command line.

It installs through Homebrew on macOS, Linux, and WSL, through an install script for macOS, Linux, and WSL, or through a PowerShell script on Windows. The shell install script can fetch the latest release, the latest pre-release, or a specific version. Prebuilt binaries are available from GitHub Releases. The tool is aimed at developers and operators who deploy and manage applications on fly.io.

### Installation

```bash
# via Homebrew
brew install flyctl
```

```bash
# via Install script (macOS, Linux, WSL)
curl -L https://fly.io/install.sh | sh
```

```bash
# via PowerShell (Windows)
iwr https://fly.io/install.ps1 -useb | iex
```

## Alternatives

- [nap](https://www.trmn.sh/tools/nap.md): Code snippet manager with CLI and TUI for creating, organizing, and accessing snippets in the terminal (Go, 2.2k stars)
- [octocov](https://www.trmn.sh/tools/octocov.md): Code metrics toolkit for collecting coverage, code-to-test ratio, test execution time, and custom metrics from multiple report formats (Go, 517 stars)
- [awsesh](https://www.trmn.sh/tools/awsesh.md): TUI and CLI tool for managing AWS SSO sessions with fuzzy search, account switching, and shell integration. (Go, 143 stars)
- [envdiff](https://www.trmn.sh/tools/envdiff.md): Snapshots a machine's system info, runtimes, env vars and network config to JSON, diffs snapshots, and validates environments against a YAML file. (Go, 25 stars)
- [freeze](https://www.trmn.sh/tools/freeze.md): Generate PNG, SVG, and WebP images of code and terminal output with syntax highlighting and customizable styling. (Go, 4.9k stars)

---

Canonical: https://www.trmn.sh/tools/flyctl