Create a workflow
A workflow pairs a writer, the agent that does the work, with up to five reviewers who check each result. The writer keeps going until the reviewers accept the work or a guardrail stops it. You save the workflow once and choose the goal each time you run it.
- Open the Workflows tool and choose New workflow.
- Name the workflow: enter a Workflow name, then choose Continue.
- Choose the writer: set its Role name, pick the Agent tool, and adjust the Writer instructions. Choose Continue.
- Build the review team: choose Add reviewer for each reviewer you want, and give each a Role name, Agent tool and Review instructions. Reviewers are optional and run in order after the writer. Choose Continue.
- Set guardrails: set Maximum iterations, Total runtime (minutes) and Per-role timeout (minutes). The defaults are 10 iterations, 240 minutes and 30 minutes.
- Check the Workflow summary and choose Create workflow.
No agent tools to choose from?
You need at least one detected agent tool before you can create a workflow.
Edit or delete a workflow
Your workflows are listed under Saved workflows. Click a workflow's pencil button to change it, then choose Save changes on the last step. Click its trash button to delete it.
Run a workflow
Give each run one clear outcome.
- Under Saved workflows, choose Run beside the workflow.
- Choose the run goal: pick a Goal template, such as Implement spec, Complete task, Fix failing CI or Address review feedback, or choose Start without a template.
- If the template needs one, choose the Spec or Task, or the pull or merge request with review comments. Then describe the outcome in Run goal, or add optional Additional instructions. Choose Continue.
- Set run guardrails: change the limits for this run only, if needed. The saved workflow is not changed. Choose Continue.
- Review and start: check the Branch prefix and Branch name for the run's worktree, review the Run summary, and choose Start workflow.
Where the work happens
In a Git repository, Nora creates a separate worktree on the branch you named, so the run's changes stay out of your checkout. In a folder that isn't a Git repository, the writer works in the project folder itself.
Follow a run
The run details open as soon as the run starts. To come back to them later, click the run under Runs in the Workflows tool.
- Workflow progress lists each stage, from preparing the project through each role to the final outcome.
- Recent activity shows what just happened.
- Live output shows agent messages and results as they arrive.
A run ends when the reviewers accept the work, the iteration limit is reached or the total runtime runs out.
Pause, resume or cancel a run
Use the buttons at the bottom of the run details. Pause pauses the run and Resume carries on from where it stopped. Cancel ends it for good. Choose Back to workflows to return to the list; the run keeps going.
Open a pull or merge request from a run
A completed run's changes stay on its own branch until you open a request for them.
- When a run has completed, open its details.
- Choose Create PR / MR.
- Check the title, description and branches in the dialog, then create it.
Delete a run
Under Runs, click the trash button beside a run that is paused, completed or cancelled. A run that is still going can't be deleted; pause or cancel it first.