Skip to content

For the complete documentation index, see llms.txt. Markdown versions are available by appending .md to documentation page URLs. Read the agent handbook.

Zortex Docs
Start searching Install Vision
Updates

Updates

Check an update offer, apply it to the existing installation, restart, and verify the loaded version.

On this page

Product updates install executable behavior. Handbook updates change the canonical guidance. A newer web page does not install a missing command, and an offline installation can keep using an older verified handbook copy.

Check the installed product

Shell
indra --version
zortex update check

The check reports the current offer or why automatic updating is unavailable. It does not download and apply the product merely because you ran a check.

Use the zortex executable from the installation you intend to update. If a different package owns the global command, inspect its path and help first.

Apply the offered version

Use the exact version and token returned by the successful check:

Shell
zortex update apply --version "<returned-target-version>" --confirmation-token "<returned-token>"

The token binds application to that checked offer. Do not fabricate it, reuse a stale offer, or substitute a version copied from this handbook.

For a local MCP agent, call indra.update:

JSON
{"operation":"check"}

Then, when an applicable offer is returned:

JSON
{
  "operation": "apply",
  "version": "<returned-target-version>",
  "confirmationToken": "<returned-token>"
}

Remote MCP does not expose this updater. An already authorized update should continue through verification without another confirmation prompt.

Restart and verify

Existing hosts and MCP sessions must restart to load the new runtime. Preserve the same Vault, source selections, and launch environment.

  1. Stop the existing background owner with the CLI belonging to that installation.
  2. Restart the appropriate host and agent session.
  3. Check indra --version.
  4. Run a small relevant operation, such as inspecting onboarding and reading one ready source.
  5. Confirm that the tool or behavior needed for your task is now available.

If an incompatible old owner is still running, use its previous entrypoint to stop it. Keep the old installation available until shutdown is confirmed. An IPC mismatch or failed status read is not proof that the owner has stopped.

For a package replacement that changes the Codex binding, use the supported indra setup codex --refresh procedure and restart Codex. A failed ownership check should be investigated rather than bypassed.

When automatic updating is unavailable

Older releases without this updater need a supported ordinary package upgrade. Store-managed installations, temporary package caches, or source workspaces can require a different update route. Follow the installed check's diagnosis and the current installation guide.

ZORTEX_UPDATES=0 disables discovery and application for launches with that setting. Respect it when operating an installation.

If verification or application fails, retain the current working installation and its root. A failed update is not a reason to create a new Vault or reconnect every source.

Refresh the handbook

Where the documentation reader is installed, indra.instruction {} and indra.handbook {} return a documentation object with its version, hash, source, check time, and stale state.

The reader checks the canonical web manifest on an eligible read, with a five-minute refresh interval. A verified cache or bundled copy remains available when the website cannot be reached. Read again after the interval when connectivity returns.

The metadata tells you whether the guidance came from web, cache, or bundled. It does not change the installed tool schema.

A handbook edit can be published independently. It does not automatically require product code, an offline-package rebuild, or a release. When implementation work later addresses a mismatch, it should meet the intended handbook experience rather than weakening the guidance to excuse the defect.

Suggested