Setting up Autopilot

Connect a Space to a repository. When supported repository events arrive, DocuWriter.ai reviews the code changes and suggests documentation updates.

Two ways to connect

flowchart LR
    A[Pick a connection method] --> B[GitHub App]
    A --> C[Provider connection]
    B --> D[Recommended for supported GitHub Autopilot flows]
    C --> E[GitHub, GitLab, Bitbucket, or Azure DevOps]
    D --> F[Link a repo to a Space]
    E --> F

Option 1: GitHub App

Install the DocuWriter.ai Autopilot GitHub App at github.com/apps/docuwriter-ai-autopilot.

Use this path for supported GitHub Autopilot flows, including webhook delivery and PR comments for repositories where the app is installed.

Steps

  1. Open the install URL above and click Install.
  2. Pick the GitHub account or organization.
  3. Choose All repositories or select specific repositories. You can change this later in GitHub settings.
  4. Confirm the installation.
  5. Return to DocuWriter.ai and link the repository to a Space.

Some manual repository selection and generator flows may still require a GitHub provider connection.

Option 2: Provider connection

Use a provider connection for GitHub, GitLab, Bitbucket, Azure DevOps, or when a workflow asks you to authorize repository access directly.

  1. In DocuWriter.ai, open Git Connections from the top navigation bar.
  2. Choose the provider you want to connect.
  3. Complete the provider authorization flow or token setup.
  4. Grant repository access when prompted.

Azure DevOps offers two connection methods: Personal Access Token, which works with all account types, and OAuth, which requires an Azure AD organizational account.

You can use the GitHub App and provider connections side by side.

Link a repository to a Space

flowchart TD
    Open[Open the Space] --> Settings[Settings sidebar]
    Settings --> Add[Add repository link]
    Add --> Pick[Pick provider and repository]
    Pick --> Branch[Choose branch]
    Branch --> Filters[Optional path filters]
    Filters --> Save[Save]
    Save --> Live[Link is live]

You can link the same Space to multiple repositories, such as a frontend repository and a backend repository feeding one set of docs.

Path filters (optional)

Use path filters when only part of a repository should affect a Space. Add one filter per line.

Filter Meaning
src/ Watch files under src/
app/Models/ Watch model files
api/ Watch API-related files

If an event touches nothing matching your filters, no suggestions are generated for that event.

Doc-only, lockfile-only, and very small changes can still be skipped automatically even when they match a filter.

Per-link settings

Each repository link has its own settings:

  • Notifications: email by default; Slack, Microsoft Teams, Google Chat, and generic webhook are available on Enterprise / Unlimited. See Notifications & emails for setup.
  • Auto-apply threshold: available on plans that include auto-apply. Set the confidence threshold from 50% to 100%.
  • AI context instructions: optional guidance the AI follows when writing suggestions for this link.
  • Trigger events: choose whether push events, merged pull request events, or both should run Autopilot when supported by the provider connection.

Provider event support can differ. GitHub supports the broadest pull request event coverage through supported GitHub Autopilot flows. Other providers may trigger primarily on push, merged, or fulfilled pull request events depending on the event data they send to DocuWriter.ai.

Azure DevOps webhook setup may require manual configuration in Azure DevOps.

Next