Skip to main content

Use the CLI

Listen for queued work

Run the local listener that receives queued tasks and starts the configured coding-agent command.

Run the listener from an initialized repository to receive queued work for its selected project.

Start the listener

alterac-ai listen

The listener reports the signed-in account, polls for queued tasks, captures immutable work-run context, and starts the selected coding-agent command. Press Ctrl+C to stop it.

The selected project's organization must have an active license. If it expires, the listener reports the license problem and cannot poll, mark approval waiting, or start another queued run. A worker that already started can still retrieve its exact context and submit its final summary and hand-off so the run reaches review safely. Stored CLI authentication is not removed; restore the organization license or contact platform support, then run the command again.

Choose a trust mode

Before dispatching a changed or unapproved coding-agent command, the listener can wait for local confirmation. Review or change this repository-local setting with:

alterac-ai config trust

The trust setting governs local command-template approval, not who can access alterac.ai. If the listener cannot open a worker terminal, it prints the command to run manually.

Adjust polling carefully

--poll-interval-seconds accepts whole seconds from 1 through 300. The default is 5 seconds. See CLI command reference for trust and listener details.