The Construct CLI 1.2.10 - 2026-02-06

Release Notes

Changed

• Design Docs Mount Model: Updated DESIGN.md to document the active dual mount behavior: /projects/<folder> for ephemeral runs and /workspaces/<hash>/... for daemon multi-root runs.

Fixed

• Clipboard Host Command Timeouts (macOS): Added a timeout for osascript image reads in the host clipboard bridge to prevent hangs when reading image clipboard data.
• Clipboard HTTP Server Timeouts: Added read/write/idle timeouts to the clipboard HTTP server to avoid stuck connections.
• Codex WSL Fallback Request Timeout: Added curl connection and overall time limits in powershell.exe to avoid indefinite waits when fetching clipboard images.
• Codex Daemon Workspace Path Mapping: Added /mnt/c/workspaces -> /workspaces aliasing and expanded shim path handling so WSL-style fallback paths resolve correctly in daemon sessions.

The Construct CLI 1.2.9 - 2026-02-06

Release Notes

Changed

• Design Docs Mount Model: Updated DESIGN.md to document the active dual mount behavior: /projects/<folder> for ephemeral runs and /workspaces/<hash>/... for daemon multi-root runs.

Fixed

• Clipboard Host Command Timeouts (macOS): Added a timeout for osascript image reads in the host clipboard bridge to prevent hangs when reading image clipboard data.
• Clipboard HTTP Server Timeouts: Added read/write/idle timeouts to the clipboard HTTP server to avoid stuck connections.
• Codex WSL Fallback Request Timeout: Added curl connection and overall time limits in powershell.exe to avoid indefinite waits when fetching clipboard images.
• Codex Daemon Workspace Path Mapping: Added /mnt/c/workspaces -> /workspaces aliasing and expanded shim path handling so WSL-style fallback paths resolve correctly in daemon sessions.

The Construct CLI 1.2.8 - 2026-02-05

Release Notes

Added

• Config Defaults Check: construct sys doctor now reports missing default config keys and can append them with --fix (with backup).
• Construct PATH Export: Entry point now writes a construct-managed PATH profile to stabilize login shells.
• Non-Daemon PATH Injection: Inject full Construct PATH for setup, container runs, and daemon exec sessions via CONSTRUCT_PATH.
• PATH Sync Test: Added a unit test to verify PATH parity across Go and template files.
• Clipboard Patch Flag: Added agents.clipboard_image_patch to enable/disable clipboard image patching and codex WSL clipboard workaround.
• Brew Package: Added nano to default Homebrew packages.

Changed

• Safe Defaults Overlay: Defaults are now applied in code when config values are missing.
• No Config Auto-Merge: Removed automatic config.toml merges and config template hash tracking.

Fixed

• Agent PATH Parity: Hardcoded PATH across env, entrypoint, compose, and Dockerfile to keep agent binaries available everywhere.
• Setup + Daemon PATH Injection: Ensure full Construct PATH is injected for setup runs and daemon exec sessions so tools are available everywhere.

The Construct CLI 1.2.7 - 2026-02-05

Release Notes

Added

• Config Defaults Check: construct sys doctor now reports missing default config keys and can append them with --fix (with backup).
• PATH Sync Test: Added a unit test to verify PATH parity across Go and template files.
• Clipboard Patch Flag: Added agents.clipboard_image_patch to enable/disable clipboard image patching and codex WSL clipboard workaround.
• Brew Package: Added nano to default Homebrew packages.

Changed

• Safe Defaults Overlay: Defaults are now applied in code when config values are missing.
• No Config Auto-Merge: Removed automatic config.toml merges and config template hash tracking.

Fixed

• Agent PATH Parity: Hardcoded PATH across env, entrypoint, compose, and Dockerfile to keep agent binaries available everywhere.
• Setup + Daemon PATH Injection: Ensure full Construct PATH is injected for setup runs and daemon exec sessions so tools are available everywhere.

The Construct CLI 1.2.6 - 2026-02-04

Release Notes

Added

• PATH Sync Test: Added a unit test to verify PATH parity across Go and template files.

Fixed

• Agent PATH Parity: Hardcoded PATH across env, entrypoint, compose, and Dockerfile to keep agent binaries available everywhere.
• Setup + Daemon PATH Injection: Ensure full Construct PATH is injected for setup runs and daemon exec sessions so tools are available everywhere.

The Construct CLI 1.2.5 - 2026-02-04

Release Notes

Added

• PATH Source of Truth: Generate PATH blocks from internal/env/env.go via make gen-paths and wire it into make build.

Fixed

• Agent PATH Parity: Expanded Construct PATH to include pnpm, Yarn, Go, and Composer tool bins across env, entrypoint, compose, and Dockerfile.
• Setup + Daemon PATH Injection: Ensure full Construct PATH is injected for setup runs and daemon exec sessions so tools are available everywhere.

The Construct CLI 1.2.4 - 2026-02-04

Release Notes

Added

• PATH Source of Truth: Generate PATH blocks from internal/env/env.go via make gen-paths and wire it into make build.

Fixed

• Agent PATH Parity: Expanded Construct PATH to include pnpm, Yarn, Go, and Composer tool bins across env, entrypoint, compose, and Dockerfile.
• Setup + Daemon PATH Injection: Ensure full Construct PATH is injected for setup runs and daemon exec sessions so tools are available everywhere.

The Construct CLI 1.2.3 - 2026-02-03

Release Notes

Added

• Provider Key Passthrough: Always forward common provider API keys into containers, preferring CNSTR_ values and falling back to unprefixed names when empty or missing. Keys: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, ZAI_API_KEY, OPENCODE_API_KEY, HF_TOKEN, KIMI_API_KEY, MINIMAX_API_KEY, MINIMAX_CN_API_KEY.

Fixed

• Daemon SSH Agent Bridge: Ensure daemon execs initialize the SSH agent proxy and expose SSH_AUTH_SOCK on macOS so agents can access forwarded keys.

The Construct CLI 1.2.2 - 2026-02-01

Release Notes

Fixed

• Daemon SSH Agent Bridge: Ensure daemon execs initialize the SSH agent proxy and expose SSH_AUTH_SOCK on macOS so agents can access forwarded keys.

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.