← Back

Connect Your GitHub Account

← Back to all docs

Connect Your GitHub Account

Learn how to securely connect your GitHub account to ArkT for enhanced integration capabilities

referencebeginnerā±ļø5 min
Home/Documentation/Connect Your GitHub Account

Learn how to securely connect your GitHub account to ArkT for enhanced integration capabilities

šŸ”— Connect Your GitHub Account

Connect your GitHub account to ArkT to unlock powerful integration features. Pull in repository information, link issues, and visualize your development workflow - all within your diagrams.

✨ Key Benefits

Secure OAuth authentication - no password sharing

Fine-grained permissions - you control what ArkT can access

Revocable access - disconnect anytime from GitHub settings

Privacy-focused - only accesses what you explicitly authorize

How GitHub Integration Works

ArkT uses GitHub OAuth for secure authentication. This industry-standard protocol ensures your credentials remain safe:

•

Initiate Connection

Click "Connect GitHub" in ArkT settings or when creating an integration node

•

GitHub Authentication

You're redirected to GitHub's official login page (you can verify the URL is github.com)

•

Review Permissions

GitHub shows exactly what ArkT is requesting access to

•

Authorize Access

You explicitly grant permission for ArkT to access specified resources

•

Secure Token Exchange

GitHub sends an encrypted token to ArkT - your password is never shared

•

Ready to Use

ArkT can now access authorized GitHub data on your behalf

šŸ”’ Security Note

ArkT never sees or stores your GitHub password. All authentication happens directly with GitHub.

Understanding Permissions

ArkT requests minimal permissions needed for integration features:

Read Repository Information

View repository names, descriptions, and basic metadata to link to your diagrams

Read Issues

Access issue titles, descriptions, and status to visualize workflows

Read Pull Requests

View PR information to track code review processes in diagrams

āš ļø What ArkT Cannot Do

ArkT does not request permission to:

āŒ Write to your repositories āŒ Delete anything āŒ Access private emails āŒ Modify account settings āŒ Access payment information

Managing Permissions

You can review and modify granted permissions anytime:

•

Visit GitHub Settings

Go to github.com → Settings → Applications → Authorized OAuth Apps

•

Find ArkT

Locate "ArkT" in your list of authorized applications

•

Review or Revoke

Click to see detailed permissions or revoke access completely

Step-by-Step: Connect GitHub

•

Open Settings

Click your avatar → Settings, or press Shift+S

•

Navigate to Integrations

Find the "Integrations" tab in the settings panel

•

Connect GitHub

Click the "Connect GitHub Account" button

•

Authorize on GitHub

You'll be redirected to GitHub - log in if needed and review the requested permissions

•

Grant Access

Click "Authorize ArkT" on the GitHub authorization page

•

Return to ArkT

You'll be redirected back automatically - your account is now connected!

āœ… Connection Successful

Once connected, you'll see your GitHub username displayed in the Integrations settings.

Using GitHub Integration Nodes

After connecting, you can create integration nodes to link GitHub resources:

•

Create Integration Node

Press "I" or click the integration button in the toolbar

•

Select GitHub

Choose "GitHub" from the integration type dropdown

•

Choose Resource

Select what to link: Repository, Issue, or Pull Request

•

Search & Select

Use the search to find your repository, issue, or PR

•

Node Created

The node displays live data from GitHub and updates automatically

šŸ’” Pro Tip

Integration nodes automatically refresh data periodically. Click the refresh icon on any node to update immediately.

Troubleshooting Common Issues

Connection Failed

Ensure pop-ups are enabled for ArkT. GitHub authorization opens in a new window.

Can't See Repositories

Check that you granted repository access during authorization. Reconnect to update permissions.

Integration Nodes Show Errors

Verify your GitHub connection is still active in Settings → Integrations. Token may have expired.

Want to Disconnect

Go to Settings → Integrations → Disconnect GitHub, or revoke from github.com settings.

šŸ”§ Need More Help?

If issues persist, try disconnecting and reconnecting your GitHub account. This refreshes the authentication token.

Privacy & Security

Your security is our priority:

Encrypted Storage

Authentication tokens are encrypted at rest and in transit

No Password Storage

ArkT never stores your GitHub password

Minimal Permissions

Only requests read access to what's needed for integration features

Easy Revocation

Disconnect anytime from ArkT settings or GitHub directly

10 of 10

Related Articles

Keyboard Shortcuts Reference

Complete guide to all keyboard shortcuts for faster workflow

referencebeginner
5 min

Create Your First Node

Master the basics of node creation in ArkT diagrams

basicsbeginner
5 min

Edge Connections

Learn how to connect nodes with directional edges

basicsbeginner
7 min

On This Page

IntroductionHow It WorksUnderstanding PermissionsConnecting Your AccountUsing GitHub IntegrationTroubleshooting