Coding runs and delivery
Coding agents can change code in your repositories for a task, an epic or a repository. Helpin's built-in coding agents are Forge, which builds changes, and Lens, which reviews them. Custom agents can also be set up for repository work.
Coding agents are not available in the Community edition.
Before you start
Connect GitHub or GitLab and add the repositories agents may use. See Workspace repositories.
Set your team's delivery defaults in Settings → Projects → Delivery: the repository, the default base branch, and the Branch template used to name task branches. The template can use
{task_key},{workspace_key},{display_id},{slug}and{task_type}.
Check a task's delivery setup
Open the task and look at its Delivery panel.
Execution context shows the Base branch and the Working branch the agent will use. Select Edit context to change them.
The panel shows the Repository, Last Commit and Pull Request for the task.
Run a coding agent
On the task, choose an agent and select Run. You can also start a run from Automation → Agents with Run now.
Under Repository delivery, choose how changes should be delivered (see the table below).
Start the run.
Option | What happens |
|---|---|
Publish changes | Push repository changes and open a pull request after the run succeeds. |
Preview changes | Keep repository changes local. No automatic push or pull request. |
Coding runs may wait in a queue before they start. The run dialog tells you when this applies.
What happens during a run
The agent works in its own copy of the repository, on the task's working branch. It can read and edit files, run commands and use the tools it has been given. It may pause to ask before running a command or changing files; see Respond to approvals and questions during a run.
Open the run to watch the transcript, the files it changed and any previews.
Delivery states
The task's Delivery panel shows where the work is:
State | Meaning |
|---|---|
Not configured | No repository is set for this task. |
Configured | Ready for an agent to work. |
Changes pushed | Commits are on the working branch. |
PR open | A pull request is open. |
PR merged | The pull request was merged. |
PR closed without merging | The pull request was closed. |
PR publishing failed | Helpin couldn't open the pull request. |
Delivery progress on the task lists each run, commit, branch and pull request, with Open run, View commit, View branch and View PR links.
Check the outcome
A completed run means the agent finished. It doesn't guarantee the pull request was opened. Check the Delivery panel for the pull request before you move on. To learn how pull request events can update the task, see Closed-loop agent delivery.
Related
Was this article helpful?