The Construct CLI 1.2.1 - 2026-01-28

Release Notes

Fixed

• Daemon Yolo Flag: Avoid injecting --dangerously-skip-permissions when execing into a root-running daemon to prevent permission errors.
• Daemon User Enforcement (macOS): Run all agent execs inside the daemon as the construct user to avoid root exec on macOS.

Changed

• Run User (macOS): Force non-daemon agent runs to use the construct user to avoid root exec on macOS.

[1.2.0] - 2026-01-27

Added

• Daemon Control Commands: Added construct sys daemon subcommands to start, stop, attach, and check status of the background daemon.
• Multi-Root Daemon Mounts: Support for multiple host root mounts for the daemon with validation, overlap warnings, and deterministic mount hashing.

Changed

• Workspace Mount Path: Removed the legacy /workspace fallback; project mounts now always use /projects/<folder> via CONSTRUCT_PROJECT_PATH.
• Compose Env Injection: CONSTRUCT_PROJECT_PATH is now injected automatically for all compose-based commands to keep mount paths consistent.

Fixed

• Daemon Workdir Mapping: Improved daemon working directory mapping to resolve host paths against validated daemon mounts.

The Construct CLI 1.2.0 - 2026-01-27

Release Notes

Added

• Daemon Control Commands: Added construct sys daemon subcommands to start, stop, attach, and check status of the background daemon.
• Multi-Root Daemon Mounts: Support for multiple host root mounts for the daemon with validation, overlap warnings, and deterministic mount hashing.

Changed

• Workspace Mount Path: Removed the legacy /workspace fallback; project mounts now always use /projects/<folder> via CONSTRUCT_PROJECT_PATH.
• Compose Env Injection: CONSTRUCT_PROJECT_PATH is now injected automatically for all compose-based commands to keep mount paths consistent.

Fixed

• Daemon Workdir Mapping: Improved daemon working directory mapping to resolve host paths against validated daemon mounts.

[1.1.3] - 2026-01-26

Added

• Shared Entrypoint Hash Helper: Introduced a shared script for computing and writing entrypoint hashes, used by both setup and update flows.
• Agent Patch Script: Centralized clipboard and agent patching into a reusable script.

Changed

• Update Flow Patching: sys update now runs agent patching and writes the entrypoint hash immediately to avoid redundant setup on next run.
• Mounted Update Scripts: Update and patch scripts are mounted from the host into the container for faster iteration without rebuilds.
• Update Fallback Warning: Warns when falling back to /usr/local/bin/update-all.sh and suggests running construct sys refresh.

Fixed

• Post-Update Double Setup: Avoids re-running full setup after updates when only patching is needed.
• Rebuild Template Duplication: construct sys rebuild no longer copies container templates twice during automatic migration + refresh.
• Daemon Mount Working Dir: Agent exec in the daemon now maps the host working directory to the correct mounted path.

The Construct CLI 1.1.3 - 2026-01-26

Release Notes

Added

• Shared Entrypoint Hash Helper: Introduced a shared script for computing and writing entrypoint hashes, used by both setup and update flows.
• Agent Patch Script: Centralized clipboard and agent patching into a reusable script.

Changed

• Update Flow Patching: sys update now runs agent patching and writes the entrypoint hash immediately to avoid redundant setup on next run.
• Mounted Update Scripts: Update and patch scripts are mounted from the host into the container for faster iteration without rebuilds.
• Update Fallback Warning: Warns when falling back to /usr/local/bin/update-all.sh and suggests running construct sys refresh.

Fixed

• Post-Update Double Setup: Avoids re-running full setup after updates when only patching is needed.
• Rebuild Template Duplication: construct sys rebuild no longer copies container templates twice during automatic migration + refresh.
• Daemon Mount Working Dir: Agent exec in the daemon now maps the host working directory to the correct mounted path.

The Construct CLI 1.1.2 - 2026-01-26

Release Notes

Added

• Shared Entrypoint Hash Helper: Introduced a shared script for computing and writing entrypoint hashes, used by both setup and update flows.
• Agent Patch Script: Centralized clipboard and agent patching into a reusable script.

Changed

• Update Flow Patching: sys update now runs agent patching and writes the entrypoint hash immediately to avoid redundant setup on next run.
• Mounted Update Scripts: Update and patch scripts are mounted from the host into the container for faster iteration without rebuilds.
• Update Fallback Warning: Warns when falling back to /usr/local/bin/update-all.sh and suggests running construct sys refresh.

Fixed

• Post-Update Double Setup: Avoids re-running full setup after updates when only patching is needed.
• Rebuild Template Duplication: construct sys rebuild no longer copies container templates twice during automatic migration + refresh.

The Construct CLI 1.1.1 - 2026-01-25

Release Notes

Added

• Shared Entrypoint Hash Helper: Introduced a shared script for computing and writing entrypoint hashes, used by both setup and update flows.
• Agent Patch Script: Centralized clipboard and agent patching into a reusable script.

Changed

• Update Flow Patching: sys update now runs agent patching and writes the entrypoint hash immediately to avoid redundant setup on next run.
• Mounted Update Scripts: Update and patch scripts are mounted from the host into the container for faster iteration without rebuilds.
• Update Fallback Warning: Warns when falling back to /usr/local/bin/update-all.sh and suggests running construct sys refresh.

Fixed

• Post-Update Double Setup: Avoids re-running full setup after updates when only patching is needed.

The Construct CLI 1.1.0 - 2026-01-25

Release Notes

Improved

• Multiple performance optimizations where implemented to make the CLI faster and more efficient. Now it's fast. Really fast.

Added

• Daemon Auto-Start Service: Added sys daemon-install, sys daemon-uninstall, and sys daemon-status for managing a background daemon service (systemd) that can auto-start on login/boot.
• Daemon Auto-Start Config: New [daemon] auto_start setting to start the daemon on first agent run for faster subsequent startups.

Changed

• Faster Runtime Detection: Runtime detection now checks container, podman, and docker in parallel to reduce startup latency on multi-runtime systems.
• Daemon Exec Fast Path: When a daemon container is running, agents run via exec instead of compose run for much faster startup.
• Compose Override Caching: Docker compose override generation is cached to avoid unnecessary regeneration on repeated runs.
• Parallel Runtime Detection: Checks container, podman, and docker concurrently to cut detection latency by 0.5-1s.
• Daemon Exec Path: Agent runs reuse the warm daemon container for 2.5-7s faster startup.
• Entrypoint Caching: Skips expensive clipboard and agent patching when entrypoint hash is unchanged (200-800ms saved).
• Preemptive Services: Clipboard server and SSH bridge already start asynchronously; no added latency from sequential startup.

Fixed

• Daemon Staleness Guard: Detect stale daemon containers (old image) and fall back to normal startup with clear guidance to restart the daemon.
• Daemon Shell Exec: construct sys shell now execs a default shell when attaching to a running daemon, preventing empty exec calls.
• Post-Update Entrypoint Patching: Clearing the entrypoint hash after updates ensures new agents get patched correctly.

The Construct CLI 1.0.1 - 2026-01-21

Release Notes

Fixed

• OrbStack/Podman Sudo Compatibility: Fixed sys install-packages and sys update failing with "PAM account management error" in environments where sudo is unavailable or misconfigured (OrbStack, rootless Podman, minimal containers).
  • Install scripts now detect if running as root (no sudo needed) or test sudo availability before use
  • Gracefully skips privileged apt operations when sudo unavailable instead of failing
  • Applies to both install_user_packages.sh (generated) and update-all.sh (template)

The Construct CLI 1.0.0 - 2026-01-18

Release Notes

Added

• Production Ready: Marked Construct CLI as production ready.

The Construct CLI 0.15.11 - 2026-01-18

Release Notes

Added

• SELinux Label Control: Added sandbox.selinux_labels config to enable, disable, or auto-detect SELinux mount labels.
• Doctor Ownership Check: Added a Linux/WSL config permissions check with a chown fix suggestion for ~/.config/construct-cli.
• Automatic Config Permission Fix: On Linux/WSL, automatically detect and fix config directory ownership issues before runtime preparation, with clear messaging and user confirmation before running sudo.
• Simple Progress Mode: Added dot-based progress output for non-TTY environments and when CONSTRUCT_SIMPLE_PROGRESS=1 is set.
• Podman Rootless Support: On Linux, container now runs as user (not root) for proper Podman rootless compatibility. macOS continues to use root with gosu drop.
• Truecolor Support: Forward host COLORTERM to container, defaulting to truecolor when unset. Fixes washed-out colors over SSH.

Fixed

• SELinux Home Relabeling: Skip :z labels when running from the home directory to avoid relabel errors.
• Config Write Guidance: Emit clearer permission warnings when config-generated files cannot be written.

The Construct CLI 0.15.3 - 2026-01-17

Release Notes

Fixed

• Podman Runtime Detection: Updated Podman socket check to use RemoteSocket.Exists instead of HostSocket.Exists for Podman 5.7.1+ compatibility.
• Podman Compose Compatibility: Moved host.docker.internal mapping to docker-compose.override.yml using extra_hosts directive. podman-compose doesn't support --add-host runtime flag.