OverviewTrack your day in the InboxCreate an issueWork the boardManage an issueFlag and resolve impedimentsPlan cyclesComplete a cycleGenerate release notesOrganize domainsPlan initiativesScore outcomes and estimatesRecord design workConnect GitHubLink branches and PRs to issuesManage repositoriesDelegate issues to the coding agentWho sees and does what in ForgeTroubleshooting
GITHUBGuide

Delegate issues to the coding agent

Coding sessions let a Forge admin delegate a Forge issue to an AI agent: the agent clones the linked GitHub repository, implements the fix based on the issue description, and opens a draft pull request for review.

Before you start

  • GitHub must be connected and at least one repository must be synced under Repositórios (Repositories).
  • Only Forge admins (Administrador) can see and start coding sessions.

Delegate an issue

  1. 1

    Open the issue in Forge.

    The Sessões de código (Coding sessions) section appears in the right sidebar of the issue, visible only to admins.

  2. 2

    Click `Nova sessão` (New session).

    The Nova sessão de código (New coding session) dialog opens. Select the Repositório (Repository) and Branch de origem (Base branch) — the agent will create the issue branch from that reference and open the pull request against it.

  3. 3

    Add `Instruções` (Instructions) — optional.

    Use this field to guide the agent: implementation strategy, constraints, files to avoid, etc.

  4. 4

    Click `Iniciar sessão` (Start session).

    The agent enters the queue (Na fila — Queued), begins execution (Em execução — Running), and opens the draft pull request when done.

    result
    The Coding sessions section shows the session status in real time: Na fila → Em execução → PR aberto (Queued → Running → PR open).
  5. 5

    Click `Ver pull request` (View pull request) when it appears.

    The link takes you directly to the draft PR on GitHub. Review, adjust, and approve it through the normal GitHub workflow.

Monitor and restart sessions

The Sessões de código section shows the most recent session. Click it to open the full session history and follow the Atividade (Activity) log for each one. If a session fails (Falhou — Failed), click Tentar novamente (Try again) to start a new one with the same parameters.

One active session at a time

The Nova sessão button is disabled while a session is running for the same issue. Wait for it to complete or fail before starting another.

Configure the agent model

By default the agent uses Claude Opus 4.8 (highest quality). To switch to Claude Sonnet 4.6 (lower cost), go to Forge → GitHub and find the Modelo do agente de código (Coding agent model) card. Team admins and managers can change this setting — saving requires two-factor authentication (MFA).

Next

Connect GitHubManage repositoriesWho sees and does what in Forge