The Construct CLI 1.7.6

[1.7.6] - 2026-05-03

Fixed

• OrbStack Repeated Launch: On macOS, Construct no longer brings OrbStack to the foreground on every invocation when Docker is already running in the background. startRuntime now checks docker info before launching OrbStack, avoiding redundant open -a OrbStack calls.

The Construct CLI 1.7.5

[1.7.5] - 2026-05-02

Fixed

• pnpm Update False Failure: ct sys update reported pnpm: FAILED because topgrade's native pnpm step exits non-zero when pnpm is managed by Homebrew. Topgrade's pnpm step is now disabled — brew already handles pnpm updates.

The Construct CLI 1.7.4

[1.7.4] - 2026-04-28

Fixed

• OpenCode First-Run SQLite Error: Pre-creates ~/.local/share/opencode and ~/.config/opencode directories before container startup, preventing the DrizzleError: Failed to run the query 'PRAGMA journal_mode = WAL' failure that occurred on first run in a fresh Construct environment.

The Construct CLI 1.7.3

[1.7.3] - 2026-04-27

Changed

• Expanded Default Env Passthroughs: Fresh configs now default sandbox.env_passthrough to include GITHUB_TOKEN, GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, QWEN_API_KEY, MINIMAX_API_KEY, KIMI_API_KEY, ZAI_API_KEY, MIMO_API_KEY, OPENCODE_API_KEY, and CONTEXT7_API_KEY.

The Construct CLI 1.7.2

[1.7.2] - 2026-04-21

Added

• Host Service Env: New host_service_env field in [sandbox] config section. Injects environment variables into the container with localhost/127.0.0.1 automatically rewritten to host.docker.internal. Enables agents inside the sandbox to reach host services like AgentMemory without complex IP detection. Example: "AGENTMEMORY_URL=http://localhost:3111".
• AgentMemory config directory (~/.agentmemory) is now created on container first run.

Changed

• Replaced the [bridge] configuration section and internal/bridge package (IP detection, gateway probing, CONSTRUCT_* env vars) with the simpler host_service_env mechanism. The old [bridge] config is no longer recognized and should be removed from config.toml.

Removed

• Deleted internal/bridge/ package (config, detector, injector, integration).
• Removed [bridge] section from config template and BridgeConfig type.

The Construct CLI 1.7.1

[1.7.1] - 2026-04-20

Added

• Daemon Restart Command: New construct sys daemon restart command that stops and starts the daemon container in one operation. Handles all container states: missing (starts), stopped (cleans up and starts), and running (stops then starts).

The Construct CLI 1.7.0

[1.7.0] - 2026-04-16

Added

• Host Service Bridge: New [bridge] configuration section that allows sandboxed containers to access services running on the host machine. This enables AI agents to connect to local databases, APIs, and development servers without leaving the isolated environment.
• Cross-Platform Gateway Detection: Automatic host gateway IP detection supporting Docker (host-gateway, host.docker.internal), Podman (host.containers.internal), and network interface inspection across macOS, Linux, and WSL.
• Service Environment Variables: For each configured host service, automatically injects CONSTRUCT_<SERVICE>_HOST, CONSTRUCT_<SERVICE>_PORT, and CONSTRUCT_<SERVICE>_URL environment variables, plus CONSTRUCT_HOST_IP for the detected gateway.
• Configurable Failure Behavior: on_failure option in [bridge] section allows users to choose behavior when gateway detection fails: "warn" (default, continue with warning), "fail" (stop container startup), or "silent" (continue silently).
• Manual Host IP Override: Advanced manual_host_ip option for users who need to specify a custom host IP when automatic detection fails or for non-standard network setups.
• AgentMemory Integration: Out-of-the-box support for AgentMemory persistent memory server. Configure services = ["agentmemory:3111"] to enable AI agents to remember context across sessions while running in complete isolation.

Changed

• Docker Compose Override: Enhanced docker-compose.override.yml generation to dynamically inject extra_hosts configuration based on [bridge] settings and detected host gateway.
• Container Environment Injection: Extended environment variable assembly to include host service connection details when bridge is enabled.

Security

• Opt-In Security Model: Host service bridge is disabled by default (enabled = false) and must be explicitly enabled by users. This maintains construct-cli's security-first approach while providing flexibility for development workflows.
• Gateway Validation: Host gateway detection includes multiple validation methods and fallback mechanisms to ensure reliability while preventing accidental host exposure.

Documentation

• Configuration Reference: Added comprehensive [bridge] section documentation in default config.toml template with usage examples and security considerations.
• Cross-Platform Support: Documented platform-specific detection methods and troubleshooting steps for each container runtime.

The Construct CLI 1.6.4

Full changelog: 1.6.3...1.6.4

The Construct CLI 1.6.3

Full changelog: 1.6.2...1.6.3

The Construct CLI 1.6.2

Full changelog: 1.6.1...1.6.2