Quickstart

Add a Git project

Open Synara and add a local repository.

Start with a repository whose current changes are already committed or intentionally preserved. A clean starting state makes the agent's work much easier to review.

Create one task

Press mod+n or use the new-task control.

For this first task, use the local checkout and run only one agent against the repository. Use a Git worktree when you begin running multiple tasks or want stronger isolation.

Choose a provider and model

Select an available provider, model, and effort or reasoning option.

Synara uses the provider runtime and account configured on your machine. It does not add a separate Synara model plan.

Give the agent a verifiable objective

Describe:

• The outcome you want
• The files or area involved
• Important constraints
• The checks that should pass

For example:

Add an empty state to the pull-request list.

Reuse the existing shared panel components.
Do not redesign the surrounding page.
Run the focused browser test and report the result.

A bounded objective is easier to execute, review, and undo than "improve the pull-request page."

Supervise the turn

Follow the transcript and tool activity while the provider works.

Useful controls:

• mod+j opens the terminal drawer.
• mod+d opens the diff view.
• mod+shift+b opens the browser.
• Approval and user-input requests appear in the task.
• Send a follow-up when the agent needs a correction or additional constraint.
• Interrupt the turn when it is clearly heading in the wrong direction.

Do not wait passively for a final message if the intermediate work is already incorrect.

Verify the result yourself

When the turn finishes:

1. Read the agent's summary.
2. Inspect the complete diff.
3. Run the relevant tests or checks yourself.
4. Look for unrelated files, debug output, generated artifacts, or accidental deletions.
5. Keep only the changes you understand and intend to ship.

The agent's final message is a report, not proof that the work is correct.

Commit or continue to a pull request

Commit the reviewed changes when they are ready.

For GitHub repositories, continue with the pull-request workflow to push the branch, inspect the final change set, and open a PR.