FAQ & troubleshooting

Getting started

I don't have a Vyazen account / URL

Vyazen is a deployed instance. Ask whoever set it up for your team for your sign-in URL and an account. See Getting started.

I can't see my repository when connecting

Your source-control integration may not have access to that repo. For the GitHub App, an admin must grant the app access to the repository in GitHub. See Integrations.

Which branch should I pick?

The branch is the workspace the agent commits to. Pick an existing feature branch, or one your team uses for agent work — avoid working directly on your main branch.

My repository won't index / the pipeline failed

• Check the repository's status on the dashboard. If it's failed, the build of the code graph hit an error.
• Try Refresh or Resume from the repository row to retry indexing. See Connecting repositories.
• If it keeps failing, the repo may be very large or contain something the indexer can't handle — ask your admin to look at the pipeline logs.
• You can't create a task until the repository is ready.

My task instance is stuck or failed

• Check the instance status on the task (see the lifecycle table in Creating and running tasks).
• Provisioning / Starting stuck — the isolated environment is taking longer than usual; wait a moment, then Retry if it doesn't progress.
• Failed — try Retry to restart the agent's run. If it fails repeatedly, the cause is usually in the task instructions or the code; refine the description and retry.
• Terminated unexpectedly — the instance was torn down; create a new task or retry.

The agent asked me something — what do I do?

That's an approval gate. The agent pauses and shows an interactive card:

• A question with options — pick the one that matches your intent (or type your own).
• A yes/no approval — usually design sign-off before it implements. Approve to proceed, or request changes to redirect it.

Answering promptly keeps the task moving. See Working with the agent.

My pull request wasn't created

• A PR only gets created when you approve the PR proposal card. If you didn't see one, the agent may still be working or may have hit an error before reaching that step.
• Check the chat for an error or a rejected proposal. If the agent's push was rejected (e.g., the branch is protected or has conflicts), resolve the conflict or pick a branch you can push to, then have the agent retry.
• See Reviewing and merging PRs.

How do I retry or cancel?

• Retry — restart the current turn or the whole task from the task detail view.
• Interrupt — stop the current run if the agent is heading the wrong way, then redirect it in your next message.
• Terminate — tear down the instance entirely; the task record and history stay.
• See Creating and running tasks for the controls.

Feature seems missing or behaves differently

Vyazen features can vary by instance and version — some are flag-gated or depend on which integrations and models your admin has configured. If something described here isn't available to you, ask your admin whether it's enabled.

How do I get help?

• Send feedback from the feedback action (optionally with a screenshot).
• For org-level issues, contact your Vyazen admin.
• For account/access problems, ask whoever provisioned your Vyazen instance.