Install the CLI

Install the version your workspace pins, for the environment where the agent runs.

Ask the agent

Install the Context Circuit CLI version this workspace pins and verify that the
versioned executable works. Do not update the workspace template or its records.

You do not need to identify your operating-system package or run the installer yourself.

What the agent does

Reads .context-circuit/CLI_VERSION.
Detects the operating system and architecture where the agent runs. WSL uses the Linux package.
Uses the bundled cc-cli procedure to download the matching release.
Verifies its SHA-256 checksum and reported version.
Keeps the resolved versioned executable for subsequent CLI calls.
Reports what was installed without printing credentials or private provider data.

The CLI installation changes no project identity, template file, intent, plan, or repository binding.

Special cases

For a private registry, tell the agent which configured source to use and provide credentials through the host's secure mechanism—not in the prompt or workspace files.

Install this workspace's pinned CLI from its configured private registry. Keep
the token out of shell history and shared files.

For an offline environment:

Install the pinned CLI from the trusted archive and checksums in <path>. Verify
both before using the binary.

Installed versions can coexist. The agent resolves this workspace's versioned executable instead of assuming the shared command on PATH is correct. See version pinning for maintenance details.