Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ona.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Ona Agent includes built-in tools for GitHub and GitLab. Agents can create pull requests, manage issues, add code review comments, and search repositories without additional configuration beyond connecting your source control provider. Supported providers: GitHub (including Enterprise), GitLab (including self-hosted)
Bitbucket and Azure DevOps support repository access but agent tools are not yet available.

​
Capabilities

  • Create, update, read, and merge pull requests and merge requests
  • Add, update, and delete general and inline code review comments
  • Create, update, and manage issues and issue comments
  • Search issues and pull requests
  • Read workflow runs (GitHub Actions) and pipeline status (GitLab)
Example prompts:
  • “Create a pull request for my changes titled ‘Add input validation’”
  • “Review PR #42 and add inline comments for issues you find”
  • “Create an issue for refactoring the authentication module”
  • “Search for open issues related to ‘timeout errors‘“

​
Organization controls

SCM tools settings showing options to enable for all members, specific groups, or disabled SCM tools are enabled by default. Administrators can configure access in Settings > Agents > Policies:
  • Enabled for all members (default)
  • Enabled for specific group: gradual rollout or team restrictions
  • Disabled: agents use git commands only, no PR/issue tools
When disabled, agents can still clone, commit, and push but cannot interact with the GitHub/GitLab API.

​
Provider differences

FeatureGitHubGitLab
Inline commentsDirect commentsDiscussion threads
Draft PRs/MRsSupportedSupported
AssigneesUsername-basedRequires user IDs

​
Prerequisites

  1. Configure source control on your runner.
  2. Authorize via OAuth or PAT when creating your first environment.
Required scopes:
  • GitHub: repo, read:user, workflow (if editing Actions files)
  • GitLab: api, read_repository, read_user

​
Limitations

  • Cannot sync PR branches with base branch
  • Cannot approve or request changes on PRs

​
Troubleshooting

Verify source control is configured and you have authorized access. Restart your environment to reload tools.
Check token scopes and repository permissions. For GitHub organizations, ensure OAuth app access is granted.