Using
Alloyqa

• Open Alloyqa in your browser or download the macOS app.
• Create an account or sign in.
• Either connect GitHub and choose a repository, or provide a public GitHub repository URL.
• Integrations → GitHub explains repository access, permissions, and pull-request workflows.
• Create your first Task.
• The Alloyqa agent runs the Task in an isolated workspace.

Give a Task to Alloyqa or assign it to a teammate. Review returns the work Ready for review, while supported connected-repository Tasks can use Auto-merge.

• Alloyqa agent runs the Task remotely and continues when Alloyqa is closed.
• Review returns the work Ready for review so you can inspect the Task and its connected-repository pull request or public-repository review artifact.
• Auto-merge lets Alloyqa merge supported connected-repository Tasks when the work completes successfully.
• Use Give feedback to request a focused update, Retry to run it again, or Cancel to stop work in progress.

• For connected-repository Review Tasks, inspect the change and its pull request before merging.
• For public-repository Tasks, review the Alloyqa artifact; they are not pushed to GitHub or available for merge.
• For supported connected-repository Auto-merge Tasks, Alloyqa can merge when the work completes successfully.
• Review changes on the web or in the macOS app.
• When supported, local iOS and macOS Previews are available through the macOS app, not in the browser.
• Give feedback when the change needs another pass.
• For connected-repository Review Tasks, merge the pull request when you are ready.
• Use Ship Together to prepare several ready Tasks as one release.

A Project gives related work a shared outcome. Add human and Alloyqa Tasks under the same Project to keep progress visible in one place.

• Use Ideas to capture work that is not ready to become a Task yet.
• Use Reviews to keep discussion and decisions close to the work.

Alloyqa agent runs Tasks in isolated Cloud workspaces. Alloyqa agent usage is billed separately based on usage and requires available Cloud balance. You can optionally use Open in Codex to inspect an existing change manually.

• Tasks run remotely and continue when Alloyqa is closed.
• See Security at Alloyqa for details about credentials, repository access, execution environments, and logs.

Cloud balance is empty

Alloyqa agent usage requires available Cloud balance. Go to Billing & plan to add balance, then try again.

A Task was interrupted

Tasks continue remotely when Alloyqa is closed, but can still be interrupted if execution fails. Open the Task for details, then retry when you are ready.

GitHub access or a Task failed

For connected-repository Tasks, reconnect GitHub or update its repository access if needed. For public-repository Tasks, confirm that the URL points to a publicly accessible GitHub repository. Use the Task details to review the failure and retry after resolving the issue.