Fix repository setup

Use this page when repository commands cannot find valid .alterac-ai setup, select the wrong project, or report that managed guidance needs an update.

Open a terminal in the intended repository and run:

alterac-ai init

Sign in if prompted, select the project that should own this repository's work, choose the requested trust setting and managed instruction-file option, and let initialization finish.

The expected result is a local .alterac-ai configuration and a confirmation of the selected project. Do not copy .alterac-ai from another repository, because its selected project and local trust choices may not apply here.

Run alterac-ai init again from this repository and select an available project. If the intended project is absent, confirm that you signed in with the intended account and that its access is still active. Do not treat a missing project as proof that it exists or that another account can access it.

The expected result is a confirmation for the intended project. Restart any local listener after changing the selection.

Run:

alterac-ai docs-update

This refreshes the CLI-managed guidance for the existing setup. If docs-update says the setup lacks a required selection, rerun alterac-ai init and choose the current options.

The expected result is an up-to-date managed bundle without replacing your unrelated repository files. For a changed coding-agent command, review the local trust prompt before approving it.

Open Install the CLI, choose the archive for your operating system and processor, verify its SHA-256 value, and follow the per-user installation steps.

If the download page shows no archive links, use its retry action after checking your connection. Do not invent a versioned URL when the page reports malformed, unsupported, missing, or unavailable release information.

The expected result is a new terminal where alterac-ai --version prints the stable version shown on the download page. After it is available, return to alterac-ai init.

If an ordinary command reports that your installed CLI is older than the available stable version, open Install the CLI, verify the current archive, and repeat the manual installation steps. The original command still runs normally, and the CLI does not install an update for you.

Open a new terminal after replacement and run alterac-ai --version. The expected result is the stable version shown on the installation page.

For sign-in failures, see Fix CLI login. For listening and local approval problems, see Fix the local listener.