From 07956931c95a92b7fae297143d8823143537116f Mon Sep 17 00:00:00 2001 From: ralphstodomingo Date: Mon, 27 Jul 2026 16:33:34 +0800 Subject: [PATCH] docs: document extension install-consent and auto-update settings MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds an "Extension settings" section to the IDE page covering `altimate.codeRequireConsent` (ask before installing the CLI, default off) and `altimate.codeAutoUpdate`, plus a description of how the extension installs the CLI natively (HTTPS from GitHub releases, sha256-verified against checksums.txt, into ~/.altimate/bin — no shell scripts, nothing outside the home directory). Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_017SDUgAmfrsMTXpk7wDpbeu --- docs/docs/usage/ide.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/docs/usage/ide.md b/docs/docs/usage/ide.md index d2fad74a01..4c014f0ea1 100644 --- a/docs/docs/usage/ide.md +++ b/docs/docs/usage/ide.md @@ -45,6 +45,17 @@ This opens the Altimate Code chat panel where you can interact with altimate age The extension uses your existing `altimate-code.json` config. No additional IDE-specific configuration is required. Warehouse connections, LLM providers, permissions, and agent settings all carry over. +### Extension settings + +The extension contributes these VS Code settings (Settings → search "altimate"): + +| Setting | Default | Description | +|---|---|---| +| `altimate.codeRequireConsent` | `false` | Ask before downloading and installing the altimate-code CLI. By default the extension installs the CLI automatically the first time chat opens. When enabled, chat shows an install prompt instead — nothing is downloaded until you confirm, and declining shows manual install instructions. | +| `altimate.codeAutoUpdate` | `true` | Keep the CLI up to date automatically in the background. Checked at most once a day, and only runs when the CLI is already installed. | + +The extension installs the CLI natively: the release archive is fetched over HTTPS from [GitHub releases](https://github.com/AltimateAI/altimate-code/releases), verified against the release's `checksums.txt` (SHA-256), and placed in `~/.altimate/bin` — no shell scripts are executed and nothing outside your home directory is modified. Environments that prefer full control can enable `altimate.codeRequireConsent` via managed settings, or pre-install the CLI themselves (the extension uses any `altimate` found on `PATH` or in `~/.altimate/bin`). + ## LLM Access You need an LLM to power the chat. Two options: