Changelog

0.1.157

Date: 2026-05-10

Main capability: release downloads.

Features

• Add a releases docs page with live CLI install commands and expandable binary artefact tables.
• Publish release manifest dates and file sizes so download pages can show current artefact metadata.
• Keep the releases page last in the docs navigation.
• Limit release install commands to the CLI, agent, and privileged agent installers, with copy buttons for each command.

0.1.156

Date: 2026-05-09

Main capability: safer production upgrades.

Fixes

• Keep workspace data protections enforced during production upgrades.
• Preserve existing provisioning, network, and volume records when upgrading older workspaces to cluster-aware infrastructure.
• Show generic service errors with correlation codes instead of backend details when an unexpected failure occurs.
• Verify production data access during rollout so incomplete upgrades are caught before the console reaches users.
• Mark sandbox runtime as unknown when its host disconnects instead of showing stale running state.

0.1.155

Date: 2026-05-03

Main capability: locked-down sandbox runtime.

Features

• Run new sandbox containers without direct network access or published host ports by default.
• Keep sandbox terminal, log, file, and lifecycle access mediated through the connected agent.
• Add a Host Agent docs article covering architecture, enrollment, CLI touchpoints, and runtime responsibilities.
• Persist agent mesh runtime status, start agent DNS and proxy listeners, and issue mesh join keys from configured mesh control settings.
• Verify locked-down sandbox services with container-internal health checks instead of host-published ports.
• Remove ephemeral agent records when agents deregister while retaining archived host logs for review.
• Show sandbox lifecycle and runtime as separate list columns with hover start and stop controls.

Fixes

• Keep the homepage Run AI Code positioning while adding self-driving infrastructure language.
• Allow provisioned sandboxes with stopped runtimes to start from the console.
• Show console errors through pop-under notifications instead of duplicating inline banners.
• Show sandbox runtime duration in the sandbox table using millisecond-based measurements formatted for reading.
• Remove source-code bootstrap fields from sandbox creation until Git integration is available.
• Keep running sandbox runtime durations ticking and roll back optimistic start or stop states after lifecycle errors.
• Include minute and second detail in sandbox runtime duration labels.
• Keep sandbox lifecycle status separate from runtime state when sandboxes are started or stopped.
• Report sandbox runtime timing from periodic agent container discovery instead of inferring duration only in the console.
• Show separate current-session and total-lifetime runtime metrics for sandboxes.
• Recognize host architecture from raw agent traits and platform strings in sandbox and host tables.

0.1.154

Date: 2026-05-02

Main capability: organization team management.

Features

• Create company organizations from the console.
• Keep the default organization personal and create new organizations as multi-user business workspaces.
• Switch the active organization for tenant-scoped infrastructure, sandbox, network, and volume views.
• Invite teammates with copyable invitation links and manage member roles from the Team page.
• Create filesystem sandbox forks through the connected host agent and complete fork status asynchronously.
• Show sandbox fork status and mode in CLI fork output.
• Add a batch sandbox fork API for speculative multi-branch workflows.
• List sandbox forks from the parent sandbox API for branch-aware workflows.
• Show parent and child sandbox branches on the console sandbox overview.
• List sandbox forks from the CLI with gstacks sandbox forks.
• Create multiple sandbox forks from the CLI with gstacks sandbox fork --count.
• Create named single or batch sandbox forks from the console sandbox overview.
• Return sandbox fork root, ancestor, and descendant lineage from the sandbox API.
• Show sandbox fork lineage from the CLI with gstacks sandbox lineage.
• Show full sandbox fork lineage in the console and support explicit batch fork names.
• Automatically archive expired disposable sandbox forks when their TTL has passed.
• Add foundational image-backed blueprint records and read APIs.
• Activate, deactivate, and delete blueprint records through the API.
• Add registry connection CRUD APIs for private image-backed blueprint sources.
• Persist internal blueprint artifact metadata, immutable digest references, and local filesystem-backed registry blobs.
• Create sandboxes from active blueprints and track the source blueprint on sandbox records.
• Show blueprint and registry inventory in the console and allow sandbox creation from active blueprints.
• Manage image-backed blueprints from the CLI with create, list, get, activate, deactivate, and delete commands.
• Manage external registry connections from the CLI and inspect internal blueprint registry repositories and artifacts.
• Create sandboxes from active blueprints with gstacks sandbox create --blueprint and capture sandbox blueprints with gstacks sandbox blueprint.
• Mark locally published image-backed blueprints active as soon as their local artifact metadata is stored.
• Normalize common registry provider aliases for Docker Hub, GHCR, GitLab, AWS ECR, Google Artifact Registry, and Azure Container Registry.
• Create sandbox-backed blueprints from the console and show sandbox provenance on blueprint registry cards.
• Add console controls for viewing, adding, and deleting external registry connections with secret-reference guidance.
• Document blueprint retention behavior and block deletion while live sandboxes still reference a blueprint.
• Validate and normalize image references before creating image-backed blueprints.
• Allow gstacks blueprint create --registry to use a registry connection name as well as an ID.
• Add repository bootstrap fields to sandbox creation so a blueprint sandbox can clone a repository into /workspace.
• Add console repository bootstrap fields and sandbox overview status for repository-backed sandboxes.
• Allow sandbox repository bootstrap to reuse an existing repository link with repository_id or gstacks sandbox create --repo-id.
• Dispatch sandbox blueprint capture through the connected agent and mark captured blueprints active or build-failed from the agent response.
• Surface operator-configured S3 blueprint repository storage settings in registry discovery without exposing access secrets.
• Require an explicit registry connection when creating image-backed blueprints with the private-image flag.
• Serve the internal blueprint repository through an embedded OCI registry and issue scoped pull credentials to agents.
• Verify local blueprint registry blob digests after writes so corrupted local artifacts fail fast.
• Queue blueprint cache warm jobs when active blueprints are created or reactivated with cache warming enabled.
• Add agent control messages for blueprint image cache warming and inventory reporting.
• Dispatch queued blueprint cache warm jobs to online agents and persist successful warm results.
• Prefer hosts with cached blueprint images during sandbox placement when capacity and policy are otherwise comparable.
• Add a manual blueprint cache warm API and include cache counts in blueprint responses.
• Enforce agent-side blueprint image cache size limits by evicting older blueprint images while preserving the warmed artifact.
• Require credential references for private image-backed blueprints and record read-only import provenance on internal artifacts.
• Publish local blueprint artifacts as OCI manifests in the embedded registry and store the manifest digest as the internal artifact reference.
• Import image-backed blueprint manifests and blobs from source registries into the embedded blueprint registry for local filesystem-backed operation.
• Add gstacks blueprint create --wait so operators can verify image-backed blueprint imports before using them.
• Document S3-backed blueprint repository durability and agent image cache behavior.

Fixes

• Keep cluster creation available from the cluster selector when a workspace has no clusters.
• Replace separate organization and cluster selects with one searchable organization-to-cluster switcher.
• Preview an organization’s clusters on hover in the workspace switcher so an organization and cluster can be selected together.
• Carry the active cluster in console paths and block host or sandbox detail views outside that cluster context.
• Dim and disable infrastructure navigation until a cluster is selected.
• Archive empty clusters from the clusters page while blocking archival when hosts or sandboxes remain.
• Move CLI API key management from Hosts into a dedicated account page linked from the profile menu.
• Require explicit cluster targets in CLI sandbox, network, and volume creation commands.
• Return absolute invitation links and log local invitation links during development.
• Report sandbox volume portal mount health separately from the host volume mount so stale sandbox binds do not appear live.
• Keep blueprint cache warm dispatch working from agent heartbeats that do not carry a human user scope.
• Explain that active child forks must be archived before archiving their parent sandbox.
• Show sandbox archive errors inside the confirmation modal instead of behind the modal overlay.
• Inherit active sandbox volume attachments when creating sandbox forks.
• Fix the registry console page crash when blueprint or repository timestamps are rendered.
• Add a dedicated Blueprints console navigation item and move blueprint inventory out of the Registry page.
• Create image-backed blueprints from the Blueprints page by entering an image reference and optional registry connection.
• Clarify that Registries are read-only source registry connections for pulling images into blueprints.
• Show blueprints in a table, support blueprint archival, and hide archived blueprints behind a toggle by default.
• Search provider images with a debounced registry-aware picker when creating image-backed blueprints.
• Create image-backed blueprints asynchronously and stream build progress while source images import.
• Show image-backed blueprint creation progress in the Blueprints table.
• Add a global console event stream that invalidates resource lists when infrastructure records change.
• Publish blueprint artifact references in Docker-pullable form and serve the embedded registry at /v2/ for agent pulls.
• Report fast container exits and captured container output in sandbox deployment logs.
• Exclude archived blueprints from the Blueprints page summary count.
• Keep revoked invitations out of the active pending-invitations list.
• Show a specific invitation error when the signed-in account does not match the invited email.
• Show signed-in email mismatches on the invitation page before accepting.

0.1.153

Date: 2026-04-26

Main capability: steadier cluster-scoped console navigation.

Fixes

• Server-render the cluster selector state so the console sidebar stays stable while client data loads.
• Rename the account Team entry to Organization and link it to the organization workspace page.
• Hide organization management for personal workspaces and prevent removing yourself or the last owner from an organization.
• Start new organizations with no default cluster, show a first-cluster empty state, and allow deleting empty business organizations.
• Server-render organization navigation and organization page data to avoid client-only account screens.

0.1.152

Date: 2026-04-26

Main capability: infrastructure clusters for sandbox capacity.

Features

• Add tenant clusters as the infrastructure boundary for hosts and sandbox placement.
• Create BYO and GlobalStacks-managed clusters from the console, CLI, and API.
• Keep existing self-hosted hosts compatible through a default BYO cluster.
• Scope hosts and provisioning tokens to BYO clusters while keeping managed clusters focused on sandbox capacity.

0.1.151

Date: 2026-04-26

Main capability: sandbox-only product focus.

Changes

• Remove project, deployment, service, build, and repository workflows from the visible console and CLI.
• Reposition GlobalStacks around secure sandbox execution for AI agents.
• Keep host, sandbox, network, volume, provisioning, and activity workflows as the primary product surface.

0.1.150

Date: 2026-04-26

Main capability: marketing site navigation pages.

Features

• Position the homepage around running AI-generated code in isolated sandboxes.
• Add Infrastructure, Talk with experts, Guides, About & contact, Privacy notice, Terms of service, and End user agreement pages.
• Replace placeholder and social footer links with links to real marketing, documentation, and legal pages.

0.1.149

Date: 2026-04-26

Main capability: automatic console deployment.

Fixes

• Trigger the rolling console deployment directly after a successful application image build.

0.1.148

Date: 2026-04-26

Main capability: simpler version pages.

Fixes

• Hide the internal commit count from console and marketing version pages.

0.1.147

Date: 2026-04-26

Main capability: production version metadata.

Fixes

• Show production build version, branch, commit, and commit count instead of development fallback values.

0.1.146

Date: 2026-04-26

Main capability: archived host cleanup.

Fixes

• Archive sandboxes whose assigned host is already archived without requiring a live runtime connection.

0.1.145

Date: 2026-04-26

Main capability: cleaner registration examples.

Fixes

• Use a neutral example name in the console registration form.

0.1.144

Date: 2025-12-28

Main capability: clearer sandbox and volume deployment feedback.

Features

• Use sandbox names with spaces and mixed formatting.
• Attach the same volume to more than one sandbox on the same host.

Fixes

• Attach volumes to sandboxes and see clear deployment feedback when a mount cannot be completed.
• Keep sandbox volume state accurate after an unsuccessful deployment.
• See sandbox volume attachment failures in the console during and after deployment.
• Clean up failed attachment state after an unsuccessful sandbox volume deployment.

0.1.140

Date: 2025-12-28

Main capability: sandbox activity in the console.

Features

• Review deployment activity inside sandbox logs.
• See deployment log lines and control-plane activity in one sandbox log timeline.
• Filter activity by sandbox, agent, event type, severity, and time range from the Activity page.

0.1.136

Date: 2025-12-28

Main capability: console network operations and host provisioning guidance.

Features

• Create sandbox networks from the console.
• Run network diagnostics from the console.
• See privileged provisioning recommended in the console where system-level host capabilities are needed.
• Select diagnostic source, target alias, and port from the console.
• Review per-agent diagnostic results for mesh join, topology, DNS records, route availability, and policy outcome.

0.1.130

Date: 2025-12-28

Main capability: CLI troubleshooting.

Features

• Use verbose CLI output when troubleshooting a failed command.
• Print underlying API and local CLI actions when --verbose is enabled.

0.1.129

Date: 2025-12-28

Main capability: safer host-agent upgrades.

Fixes

• Upgrade host agents with less disruption to active terminal work.
• Reconnect to terminal sessions after an agent restarts or reconnects.
• Install the agent more safely on hosts that already have a system service running.
• Preserve the installed agent’s upgrade source across future upgrades.
• Restart a stale agent service after an upgrade that does not replace the binary.

0.1.120

Date: 2025-12-27

Main capability: network policy checks and local access.

Features

• Allow traffic between selected sources and targets with network policies.
• Resolve a network alias and test whether a route is allowed before opening a shell.
• Join a sandbox network from a local machine for development and debugging.
• Forward a network service to localhost from the CLI.
• Check whether a source selector can reach a target alias and port.
• View local mesh join status, assigned addresses, DNS domain, and expiration.

0.1.117

Date: 2025-12-27

Main capability: network alias management.

Features

• List, add, and remove network aliases from the CLI.
• Add and remove sandbox network aliases from the console.
• Publish multiple ports for the same sandbox alias when needed.
• Resolve aliases to their network DNS names before testing traffic.

0.1.107

Date: 2025-12-27

Main capability: sandbox networks.

Features

• Create, list, and inspect sandbox networks.
• Attach and detach sandboxes from a network.
• Give sandboxes stable network aliases such as api or postgres.
• Expose one or more ports for each alias.
• Use DNS-safe network slugs and optional DNS suffixes.
• Inspect network membership, alias counts, and connected host participation.

0.1.104

Date: 2025-12-21

Main capability: account and sign-in management in the console.

Features

• Manage profile details and connected identity accounts from the console.
• Sign in with clearer email-based auth forms and Google entry points where configured.
• Edit display name and full name from the profile page.
• Review the current authenticated account and linked identity providers.

0.1.100

Date: 2025-12-21

Main capability: improved console terminal and provisioning flows.

Features

• Open host and sandbox terminals in fullscreen mode from the console.
• Use improved console forms for provisioning hosts and attaching volumes.
• Copy provisioning commands from the console.
• Revoke provisioning tokens from the console.
• Pick target kind, target ID, mount path, access mode, and read-only mode when attaching a volume.

0.1.96

Date: 2025-12-21

Main capability: system-managed host agents.

Features

• Install the host agent as a system-managed service when the host requires it.
• Use system-level installation when host features require service management or privileged volume operations.

0.1.95

Date: 2025-12-21

Main capability: sandbox volume attachments.

Features

• Attach volumes to sandboxes on connected hosts.
• Mount sandbox volumes at a chosen path.
• Attach sandbox volumes in read-only mode when needed.
• View sandbox volume mounts from the sandbox detail page.
• Delete sandbox volume attachments from the console.

0.1.92

Date: 2025-12-20

Main capability: sandbox creation and deployment visibility in the console.

Features

• Create sandboxes from the console and follow sandbox deployment status.
• Choose sandbox CPU, memory, image, and target host settings from the console form.
• Reschedule provisioning when a sandbox is pending or failed.
• Stop, start, reprovision, or archive a sandbox from its detail page.
• Open the assigned host directly from a sandbox detail page.

0.1.88

Date: 2025-12-20

Main capability: provider and repository management in the console.

Features

• Inspect provider connections and repository links from the console.
• Review provider status cards for connected and planned provider integrations.
• Filter repository links by project context.

0.1.84

Date: 2025-12-20

Main capability: fuller project workspace in the console.

Features

• Use the console on a fuller project and infrastructure workspace, including project source, builds, artifacts, deployments, domains, runtime targets, and settings pages.
• Create and delete projects from the console.
• Pin important projects for faster navigation.
• Navigate directly to project subsections with stable URLs.
• Use clickable resource cards to move between infrastructure, project, and runtime views.

0.1.79

Date: 2025-12-20

Main capability: terminal session discovery and reattachment.

Features

• List active host terminal sessions from the CLI.
• List active sandbox terminal sessions from the CLI.
• Show active or idle terminal state, connected viewer, and connection time.
• Attach to an existing host or sandbox terminal session by session ID.
• Browse terminal session state more clearly in the console before opening a new session.

Fixes

• Reconnect to host and sandbox terminals instead of starting over.
• Switch between terminal sessions more reliably in the console and CLI.
• Keep CLI terminal sessions alive during longer interactive work.

0.1.70

Date: 2025-12-20

Main capability: persistent terminal sessions across temporary connection loss.

Features

• See who is attached to a terminal session and take over or reconnect from the console.
• Reopen an existing host or sandbox terminal session from the browser after refresh.

Fixes

• Keep terminal sessions available when the browser reconnects.
• Continue host and sandbox terminal work after temporary connection loss.
• Read cleaner host-agent logs during startup.
• Ignore expected cancellation noise during agent claim polling.

0.1.55

Date: 2025-12-14

Main capability: more reliable host connectivity and name-based host terminal access.

Features

• Open host terminals by host name.
• Resolve host terminal targets by either host name or identifier.

Fixes

• Keep hosts connected to the control plane for long-running operations.
• Upgrade agents from the same configured download source used during install.

0.1.52

Date: 2025-12-13

Main capability: better console access from devices and support pages.

Features

• Navigate the console from smaller screens with mobile navigation support.
• View version information from dedicated version pages.
• Open the same console sections from desktop or mobile navigation.

0.1.51

Date: 2025-12-13

Main capability: installer scripts for the host agent and gstacks CLI.

Features

• Install the host agent from a published installer script.
• Install the gstacks CLI from a published installer script.
• Run installed binaries directly from the shell after installation.
• Upgrade the agent and CLI in place.
• Install shell completions alongside the CLI.

0.1.22

Date: 2025-12-07

Main capability: installed agent and CLI version reporting.

Features

• Check the installed version when working with support or troubleshooting an environment.
• See agent version information reported by connected hosts.

0.1.20

Date: 2025-12-06

Main capability: first console workspace for operational visibility.

Features

• Use the console to inspect infrastructure, projects, deployments, services, hosts, sandboxes, and volumes.
• Review host telemetry from the console, including CPU, memory, disk, service status, version, and Docker availability.
• Inspect host logs and operational activity without opening a terminal first.
• See sandbox placement, provisioning status, assigned host, and last update from the sandbox detail view.

0.1.18

Date: 2025-12-06

Main capability: volume lifecycle and local CLI tooling.

Features

• Create detached volumes and attach them to hosts or sandboxes, including sandbox mount paths and read-only attachments.
• List volume attachments and inspect where each volume is mounted.
• Delete volume attachments when a host or sandbox no longer needs them.
• Check the installed CLI version, upgrade the CLI, and generate shell completions.
• Generate CLI reference data for the docs site.

0.1.12

Date: 2025-12-06

Main capability: host and sandbox operations from the CLI.

Features

• List connected hosts, inspect host status, and manage host placement metadata such as tags and eligibility.
• Open interactive host terminals through the connected host agent.
• Review host runtime metadata, including connectivity status and IP address.
• Create sandboxes with CPU, memory, image, host, tag, and trait placement options.
• Filter sandbox lists by active, stopped, or archived state.
• Start, stop, deprovision, and archive sandboxes from the CLI.
• Open interactive terminals into sandboxes.

0.1.6

Date: 2025-12-06

Main capability: removed CLI workflows from the former deployment scope.

Features

• These workflows are no longer part of the GlobalStacks product surface.

0.1.1

Date: 2025-12-06

Main capability: CLI authentication.

Features

• Authenticate the CLI with a console-generated API key and check the active identity.
• Create CLI API keys from the console for local operator workflows.
• The former project setup workflows are no longer part of the GlobalStacks product surface.