Developer tools

The terminal is afirst-class client.

Anything you can do in the web dashboard, you can do directly from the Hubfly space CLI. Deploy applications, open SSH shells, create private tunnels, and stream live logs without leaving your terminal.

Explore CLI DocsInteractive TUI Guide
Project workflow01 / 03
01
SourceGo CLI with Bubble Tea TUI
02
ControlCompose Stack Orchestrator
03
ReleaseYamux WebSocket Tunnels
Hubfly space projectNetwork · volumes · domains · team access
One project model

Command line binary

A single binary for your entire workflow.

The CLI is a fast, self-contained Go binary featuring an interactive terminal interface alongside headless subcommands for CI automation and developer tooling.

01

Bubble Tea Terminal UI

Browse projects, track live container metrics, launch remote SSH shells, and toggle encrypted local tunnels with an interactive terminal interface.

Built with Charm Bubble Tea

02

Deploy Without Committing

Package and ship code directly from your working directory. Iterate rapidly locally without needing to push preliminary git commits.

03

Explainable Build Detection

`hubfly build explain` breaks down detected frameworks, base images, and build flags before running remote steps.

04

Daemon Service Mode

Run `hubfly service` as a background daemon with CORS-ready REST API endpoints for editor extensions and local tools.

hubfly-cli

$ hubfly login --token hf_pat_••••••••
Authenticated as ada@analytical.dev
$ hubfly deploy --project edge-api --region eu-west-1 --yes
Detected runtime: Go (go.mod)
Local container build succeeded
Uploading image archive to regional builder...
Deployment succeeded · bound container cont_api_987 updated
$ hubfly logs api -f
[stdout] Server listening on port 8080 · private IP 10.30.1.4

CLI Command Quick Reference

hubfly login

Flags and subcommands
--token <TOKEN>
Description
Authenticate your terminal session interactively or via personal access token

hubfly logout

Flags and subcommands
-
Description
End your current local CLI authentication session

hubfly whoami

Flags and subcommands
-
Description
Check active session credentials and verify logged-in identity

hubfly projects

Flags and subcommands
--org <ID|SLUG>
Description
Interactive terminal UI for projects, container stats, and local tunnels

hubfly deploy

Flags and subcommands
--project --region --yes --detach
Description
Build working directory locally and ship directly to your project

hubfly stack

Flags and subcommands
plan · up · status · logs · exec · down
Description
Local-first Compose stack deployment and dependency orchestration

hubfly build

Flags and subcommands
init · validate · edit · explain
Description
Manage hubfly.build.json and preview auto-detection steps

hubfly tunnel

Flags and subcommands
<container> <local> <target>
Description
Forward local ports securely over encrypted WebSocket to private containers

hubfly ssh

Flags and subcommands
<container> [-- <cmd>]
Description
Open an interactive terminal shell or execute one-off remote commands

hubfly exec

Flags and subcommands
<container> -- <cmd>
Description
Run one-shot commands inside a container namespace

hubfly logs

Flags and subcommands
<container> [-f]
Description
Stream stdout and stderr logs live to your terminal

hubfly service

Flags and subcommands
--port <port>
Description
Run a local background daemon with REST endpoints for local tools

hubfly update

Flags and subcommands
--check
Description
Check for CLI updates and upgrade your local binary to the latest version
Read full CLI documentation suite

Build engine

From source code to optimized containers.

Our build engine packages code into optimized container images using BuildKit and regional layer caching for high performance.

01

Runtime Auto-Detection

Node, Bun, Go, Python, Java, PHP, and static web apps identified instantly from manifest files.

02

Allowlisted Command Execution

Build steps and setup scripts strictly verified against platform security allowlists.

03

Layer Caching Engine

Intermediate build layers cached on regional builders for rapid redeploys.

04

Security & Vuln Scanning

Built-in Trivy security scanning highlights package vulnerabilities before promotion.

Automation

Drive platform state from code.

Manage infrastructure programmatically using typed TypeScript and native Go SDKs built for automated deployments, domain configuration, and private tunnels.

TypeScript SDK

import { HubFly } from '@hubfly/sdk';

const hubfly = new HubFly({ token: process.env.HUBFLY_TOKEN });

await hubfly.deployments.create({
  project: 'edge-api',
  image:   'registry.hubfly.space/edge-api/web:v1.7.1',
  region:  'eu-west-1',
});
@hubfly/sdk

TypeScript

Node and Bun, fully typed

hubfly-sdk/go

Go

Native package for Go backends

Comprehensive CLI Documentation Hub

Detailed guides, argument specs, environment variables, storage paths, and Compose translation engine references are available in our updated docs suite.

AI Agent SkillCLI Installation & ArchitectureAuthentication & PAT TokensInteractive Bubble Tea TUIDeployments & Build Config SchemaCompose Stack OrchestrationTunnels, SSH & Remote ExecDaemon Service Mode & Updates

Developer tools

Install the CLI and deploy in seconds.

Authenticate with your token, run `hubfly deploy` in your project root, and watch live build streams directly in your terminal.

Read CLI ReferenceInstall AI Skill