Context Circuit
Get started

Install the CLI

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

CLI 2.5.0

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

  1. Reads .context-circuit/CLI_VERSION.
  2. Detects the operating system and architecture where the agent runs. WSL uses the Linux package.
  3. Uses the bundled cc-cli procedure to download the matching release.
  4. Verifies its SHA-256 checksum and reported version.
  5. Runs every later command through the workspace's launcher, sh .context-circuit/cli COMMAND …, or .context-circuit/cli.ps1 in Windows PowerShell or cmd.
  6. 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.

Diagram viewer
100%

Drag to move around. Use the controls to zoom.

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.

The launcher

Installed versions coexist in the installers' version store. The launcher, .context-circuit/cli, runs exactly the version .context-circuit/CLI_VERSION pins from that store and never a CLI found on PATH, which is whichever version was installed last. When the pinned version is not installed, the launcher refuses, runs nothing, and names the install step, so the agent installs it and runs the command again.

The launcher looks in the installers' default command directory. If you installed with --bin-dir, set CONTEXT_CIRCUIT_BIN_DIR to that directory so the installers and the launcher agree. See version pinning for maintenance details.

On this page