Skip to content

GitHub

xyva.ai integrates with GitHub via Personal Access Tokens, providing repository browsing, pull request management, and Actions workflow visibility.

Personal Access Token Setup

  1. On GitHub, navigate to Settings > Developer settings > Personal access tokens > Fine-grained tokens.
  2. Create a token scoped to your target repository with permissions:
PermissionAccess
ContentsRead and write
Pull requestsRead and write
ActionsRead-only
MetadataRead-only
  1. In xyva, open Settings > Integrations > GitHub and paste the token.

WARNING

Fine-grained tokens are recommended over classic tokens because they limit access to specific repositories.

Repository Browsing

Once connected, the GitHub panel displays:

  • Branches -- list, switch, and compare branches
  • Recent commits -- commit log with author, message, and SHA
  • File tree -- browse repository contents without cloning locally

INFO

Repository browsing uses the GitHub REST API. Large repositories may take a moment to load the full tree on first access.

Pull Request Management

The PR section lists open pull requests with key metadata:

ColumnDescription
TitlePR title with draft indicator
AuthorGitHub username and avatar
StatusReview state (approved, changes requested, pending)
ChecksAggregated CI check status

You can create a new pull request directly from xyva by selecting a source branch, target branch, and entering a title and description.

Actions Workflow Status

xyva polls GitHub Actions and shows workflow run status for the repository:

text
deploy.yml        main     success    2m 14s
test-suite.yml    main     running    0m 48s
lint.yml          PR #87   failed     0m 22s
  • Click a workflow run to view the job breakdown and step logs.
  • Re-run failed workflows with one click.

TIP

Enable the Auto-refresh toggle to poll Actions status every 30 seconds so you always see the latest state.

Local-first QA orchestration.