Axiom Refract + GitHub
Connect your GitHub repositories for automated architectural analysis on every push, PR, or schedule
How It Works
Authorize GitHub Access
Sign in to Axiom Refract with your GitHub account via OAuth. Axiom requests read-only access to your repositories. No write permissions are required for standard scanning.
Select Repositories
Choose which repositories to analyze from your authorized organizations and personal accounts. Axiom supports both public and private repositories.
Run Your First Scan
Trigger an analysis scan from the Axiom dashboard. The scan clones your repository, parses all source files, builds the dependency graph, and delivers the architectural record.
Review Results
Access your architectural record through the web dashboard, download deliverables in JSON/Markdown/DOCX/SVG formats, or query results through the REST API and MCP server.
What You Can Do
Private Repository Support
Axiom securely clones private repositories using your stored OAuth token. Tokens are encrypted at rest and scoped to the minimum required permissions.
Organization-Wide Scanning
Scan all repositories in a GitHub organization from a single account. Organization admins can authorize Axiom for their entire org.
Branch-Specific Analysis
Analyze specific branches to compare architectural state across feature branches, release branches, and main. Scan the branch that matters for your current decision.
Webhook Integration
Configure GitHub webhooks to trigger Axiom scans automatically on push events, pull request creation, or on a scheduled cadence.
Setup
Sign in to axiomrefract.com with your GitHub account. Navigate to the Projects page and click "New Scan." Select the repository you want to analyze. Axiom will clone the repository using your authenticated credentials and begin the analysis pipeline. Results are typically available within 5-15 minutes depending on repository size.
# Clone and scan via Axiom REST API
curl -X POST https://axiomrefract.com/api/v1/jobs \
-H "Content-Type: application/json" \
-d '{
"repo_source": "https://github.com/your-org/your-repo",
"repo_type": "github",
"customer_id": "your-customer-id"
}'Why This Matters
GitHub is where your code lives. Axiom Refract integrates directly with GitHub to analyze your repositories without requiring manual file uploads, local tool installations, or changes to your development workflow. Private repositories are supported through secure OAuth token management, ensuring your code never leaves the analysis pipeline.