Learn how to securely connect your GitHub account to ArkT for enhanced integration capabilities
Connect your GitHub account to ArkT to unlock powerful integration features. Pull in files information and get your files side by side with your diagrams.
Secure OAuth authentication - no password sharing
Revocable access - disconnect anytime from GitHub settings
Privacy-focused - only accesses what you explicitly authorize
Create - Give Arkt Chat more context to answer your questions or create diagrams based on your files
GitHub integration enables powerful features that enhance your diagramming workflow with direct access to your codebase:
Seamlessly access and reference private repositories and code files directly within ArkT, without manually copying or sharing sensitive code
Give Arkt Chat more context about your diagram by referencing your GitHub files. The AI can better understand your codebase and provide more accurate assistance
Automatically generate diagrams based on your GitHub repository structure, code relationships, or file dependencies
ArkT never sees or stores your GitHub password. All authentication happens directly with GitHub.
ArkT requests minimal permissions needed for integration features. Specifically, ArkT needs read access to repository information, which includes viewing repository names, descriptions, and basic metadata to link to your diagrams. Additionally, ArkT can read issues to access issue titles, descriptions, and status for visualizing workflows, as well as read pull requests to view PR information for tracking code review processes in diagrams.
ArkT does not request permission to write to your repositories, delete anything, access private emails, modify account settings, or access payment information. All access is read-only and limited to what's necessary for the integration features.
You can review and modify granted permissions anytime. To manage your GitHub permissions, visit github.com and navigate to Settings → Applications → Authorized OAuth Apps. From there, locate "ArkT" in your list of authorized applications. You can click on it to see detailed permissions or revoke access completely if you no longer wish to use the integration.
Click your avatar → Settings, or press Shift+S
Find the "Integrations" tab in the settings panel
Click the "Connect GitHub Account" button
You'll be redirected to GitHub - log in if needed and review the requested permissions
Click "Authorize ArkT" on the GitHub authorization page
You'll be redirected back automatically - your account is now connected!
Once connected, you'll see your GitHub username displayed in the Integrations settings.
After connecting, you can create integration nodes to link GitHub resources:
Press "I" or click the integration button in the toolbar
Choose "GitHub" from the integration type dropdown
Select what to link: Repository, Issue, or Pull Request
Use the search to find your repository, issue, or PR
The node displays live data from GitHub and updates automatically
Integration nodes automatically refresh data periodically. Click the refresh icon on any node to update immediately.
If you encounter connection issues, ensure pop-ups are enabled for ArkT since GitHub authorization opens in a new window. If you can't see your repositories after connecting, check that you granted repository access during authorization and consider reconnecting to update permissions. When integration nodes show errors, verify your GitHub connection is still active in Settings → Integrations, as the authentication token may have expired. If you want to disconnect your GitHub account, you can do so from Settings → Integrations → Disconnect GitHub, or revoke access directly from github.com settings.
If issues persist, try disconnecting and reconnecting your GitHub account. This refreshes the authentication token.
Your security is our priority. Authentication tokens are encrypted at rest and in transit, ensuring your credentials remain protected. ArkT never stores your GitHub password, and only requests read access to what's needed for integration features. You can disconnect your account anytime from ArkT settings or GitHub directly, giving you full control over your data and access permissions.