Skip to main content

GitHub Integration

The GitHub integration gives agents read access to your repositories — useful for AI Readiness audits that need to reference actual code, model configs, and documentation.

Connect GitHub

  1. Go to Dashboard → Integrations → GitHub
  2. Click Install GitHub App
  3. Select which repositories to grant access to
  4. Click Install

You control exactly which repos each agent can see.

What agents use GitHub for

AI Readiness Agent

  • Reads model configuration files and inference code
  • References data pipeline code when answering AI governance questions
  • Scans for hardcoded credentials or unsafe AI practices
  • Uses README and docs files to ground questionnaire answers

Sales Agent

  • Identifies engineering leaders from commit history
  • Detects tech stack from language and dependency files
  • Finds open-source signals (stars, activity, contributors) for lead enrichment

Granting per-agent repo access

Limit which repos each agent can access:

curl -X PATCH https://api.ariftly.io/v1/integrations/github/config \
-H "Authorization: Bearer $ARIFTLY_API_KEY" \
-d '{
"agent_repo_access": {
"ai-readiness": ["org/ml-platform", "org/data-pipeline"],
"sales": ["org/open-source-lib"]
}
}'

Required GitHub permissions

PermissionScopeWhy
ContentsReadRead files in repos
MetadataReadList repos and branches
Pull RequestsReadReference PR context in analysis