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.
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.
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.
--poll-interval-seconds accepts whole seconds from 1 through 300. The default is 5 seconds. See CLI command reference for trust and listener details.
