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.

The Construct CLI 0.15.1 - 2026-01-15

Release Notes

Added

• Goose CLI: Added goose agent, with first-run configure guidance.
• Droid CLI: Added droid agent.
• Kilo Code CLI: Added kilocode agent.
• Yolo Mode Config: Added [agents] config to enable yolo flags per-agent or globally in config.toml.
• Agent Browser: Added agent-browser to default npm packages and configured its post-install dependency setup. Headless browser automation CLI for AI agents. Fast Rust CLI with Node.js fallback. No MCP required.
• LiteLLM: Added litellm to default pip packages; open-source LLM gateway/SDK with a unified OpenAI-compatible API across 100+ providers, with cost/error handling and failover.
• Post-Install Hooks: Added [post_install].commands to packages.toml, executed after all package managers finish.

The Construct CLI 0.15.0 - 2026-01-15

Release Notes

Added

• Goose CLI: Added goose agent, with first-run configure guidance.
• Droid CLI: Added droid agent.
• Kilo Code CLI: Added kilocode agent.
• Yolo Mode Config: Added [agents] config to enable yolo flags per-agent or globally in config.toml.
• Agent Browser: Added agent-browser to default npm packages and configured its post-install dependency setup. Headless browser automation CLI for AI agents. Fast Rust CLI with Node.js fallback. No MCP required.
• LiteLLM: Added litellm to default pip packages; open-source LLM gateway/SDK with a unified OpenAI-compatible API across 100+ providers, with cost/error handling and failover.
• Post-Install Hooks: Added [post_install].commands to packages.toml, executed after all package managers finish.

The Construct CLI 0.14.3 - 2026-01-13

Release Notes

Added

• Podman Compose: Added podman-compose to default brew packages in packages.toml.

The Construct CLI 0.14.2 - 2026-01-11

Release Notes

Changed

• Non-Sandboxed Aliases: ns- entries are now shell functions in the RC file, forwarding flags and args without installing extra files.
• Agent Rules Bulk Replace: sys agents-md now supports replacing all agent rules at once with a single pasted prompt, including Copilot frontmatter.