hack.foo
Guides

Cloud and remote environments

Choose the execution environment first:

  • Your local machine: Hack uses that machine's services, configuration and routing.
  • A cloud coding-agent environment: install and run Hack inside the provider's VM/container, subject to its runtime, persistence, secret and network rules.
  • An existing remote development host: Hack runs locally on that host; SSH or an agent is transport, not a built-in Hack fleet controller.
  • An application hosting service: deploying an app to ECS or an agent runtime is a separate workflow. Hack does not translate project configuration into a deployment there.

Use Managed environments for the version-specific installation contract. Verify OS/CPU architecture, matching release asset, project toolchain, Docker daemon and Compose (for that runtime), bind mounts, network access, task-time credentials and startup after snapshot restore. Installing a CLI does not supply a Docker daemon or laptop certificate trust. A macOS native bundle does not install on an Ubuntu cloud VM.

Named platform compatibility

These are documentation-based assessments, not successful Hack application tests:

PlatformSupported prerequisite evidenceRemaining verification
Cursor cloud agentsProvider-managed Ubuntu; inspect current environment/Docker documentationNested Docker, mounts, startup and task-time secrets for your app
boat.devProvider documents Linux VMs, SSH and DockerArchitecture, matching asset, persistence and app readiness
Google JulesManaged task VM; use its current tool/setup contractSecret lifetime, daemon availability and app health
Google Cloud WorkstationsManaged workstation environmentActual image, Docker access and persistent paths
code.computerExact product documentation could not be retrieved during reviewIdentity and runtime contract unverified; no setup recipe claimed
Amazon ECSApp container hosting; Fargate is not a privileged Docker hostNo verified Hack deployment adapter or full host-runtime integration
Personal fleetOrdinary CLI installation per compatible existing hostPer-host runtime, access, state and routing qualification

Use provider-approved secret injection at task time. Do not bake project keys into images or snapshots. Provider setup scripts, build snapshots and service startup may have different lifetimes. Test the actual application after every fresh task or resumed host. Remote/gateway/node/dispatch commands are outside the supported setup described here.


Source: v5 (next.12) · docs/site/guides/cloud-environments.md.

On this page