Skip to main content

Use the CLI

Initialize and refresh repository guidance

Connect a Git repository to an accessible alterac.ai project and refresh its local guidance.

Initialize a Git repository once to select its alterac.ai project and create the repository-local configuration.

Initialize the repository

Run this from the repository root.

alterac-ai init

The command signs you in when authentication is missing, lets you select an accessible project when needed, asks for a coding-agent trust mode and managed instruction files, then writes .alterac-ai/config.yaml. It also installs or refreshes the repository-local alterac.ai guidance.

Refresh local guidance

Use this after alterac.ai publishes updated repository guidance.

alterac-ai docs-update

docs-update keeps the existing managed instruction-file choice. Use --force when you need to refresh even when the installed version appears current.

Recover from setup problems

If you do not have access to a project, create or join one in alterac.ai and run init again. If the repository was not initialized, run init before commands that need a selected project. See CLI command reference for exact behavior.