Hubfly space CLI Quick Start

The hubfly CLI is the fastest way to deploy code, inspect projects, open private tunnels, stream logs, run shell commands, and automate Hubfly space from CI.

Deploy with your coding agent

Install the portable Hubfly space CLI skill to give Codex, Claude Code, Cursor, and other compatible agents a safe inspect, approve, deploy, and verify workflow.

Install The CLI

On Linux and macOS, install the latest release with the shell installer:

terminal

$ curl -fsSL https://raw.githubusercontent.com/hubfly-space/hubfly-cli/main/install.sh | bash

$ hubfly version

The installer downloads the right release archive from GitHub for your OS and CPU, then installs hubfly to /usr/local/bin or ~/.local/bin if the system path is not writable.

Platform	Install Path	Notes
Linux	`curl ... \| bash`	Supports `amd64` and `arm64`.
macOS	`curl ... \| bash`	Supports Intel and Apple Silicon.
Windows	Manual release download	Download the `hubfly_windows_*.zip` asset from GitHub releases and add it to `PATH`.
Source build	`go build -o hubfly .`	Use this when developing the CLI locally.

PATH check

If install succeeds but hubfly version is not found, add ~/.local/bin to your shell PATH and open a new terminal.

First Deploy

Start from an app directory that has a Dockerfile or a framework the Hubfly space builder can detect. Then log in and deploy.

1. Log in

terminal

$ hubfly login

Please authenticate to continue. Go to https://dashboard.hubfly.space/cli/auth to get the token

Enter your API token: hf_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

2. Deploy from the current folder

terminal

$ cd my-app

$ hubfly deploy

3. Use a non-interactive deploy when scripting

terminal

$ hubfly deploy --project my-api --region eu-1 --yes

$ hubfly deploy --project new --region rw-kigali-1 --yes

hubfly deploy creates or reuses hubfly.build.json, checks the latest hubfly-builder release unless you pin one, builds a local Docker image, uploads it to the target region, shows a diff, and waits for the deployment unless --detach is set.

Daily Commands

Goal	Command
Check the signed-in user	`hubfly whoami`
Open the project/container terminal UI	`hubfly projects`
Deploy the current app	`hubfly deploy`
Deploy with a Dockerfile	`hubfly deploy --dockerfile ./deploy/Dockerfile --yes`
Follow container logs	`hubfly logs web-app --follow`
Run one command in a container	`hubfly exec web-app -- printenv`
Open a shell	`hubfly ssh web-app`
Forward a private database	`hubfly tunnel postgres-db 5432 5432`
Check for a CLI update	`hubfly update --check`

Use In CI

In CI, create a Dashboard personal access token and store it as a secret named HUBFLY_TOKEN. Use --yes so the deploy can run without prompts.

name: Deploy
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Hubfly space CLI
        run: curl -fsSL https://raw.githubusercontent.com/hubfly-space/hubfly-cli/main/install.sh | bash
      - name: Deploy
        env:
          HUBFLY_TOKEN: ${{ secrets.HUBFLY_TOKEN }}
        run: hubfly deploy --project my-api --region eu-1 --yes --detach

Command Search

Filter every CLI command, flag, and example from one place.

Showing 19 commands

hubfly loginauth

Hubfly space CLI Quick Start

Install The CLI

First Deploy

1. Log in

2. Deploy from the current folder

3. Use a non-interactive deploy when scripting

Daily Commands

Use In CI

Command Search

Config And Storage