GitHub Integration

Connect One Horizon with GitHub to automatically track your development work, pull requests, and code contributions. This integration provides deep insights into your coding activity and project progress.

Getting Started

Prerequisites

  • One Horizon workspace - Must be set up first
  • GitHub account - Personal or organization account
  • Repository access - Access to repositories you want to track

Installation Steps

  1. Navigate to integrations - Go to your One Horizon integration settings
  2. Select GitHub - Choose GitHub from the integration options
  3. Authorize access - Grant One Horizon permission to your GitHub account
  4. Select repositories - Choose which repositories to track
  5. Configure settings - Set up any additional preferences

Access & Permissions

What We Access

  • Repository data - Issues, pull requests, and commits
  • User activity - Your commits, reviews, and contributions
  • Project boards - Kanban boards and project management
  • Repository metadata - Names, descriptions, and settings

What We Don't Access

  • Private repository code - We never access your actual source code
  • Personal information - We don't collect personal GitHub data
  • Authentication tokens - We use OAuth, never store passwords
  • Sensitive metadata - We filter out confidential information

Task Tracking

Automatic Task Detection

  • Issues - Track open and closed issues as tasks
  • Pull requests - Monitor PR creation, review, and merging
  • Commits - Track code commits and their associated work
  • Reviews - Monitor code review activity and feedback

Task States

  • Open - New issues and pull requests
  • In Progress - Active development work
  • Under Review - Pull requests awaiting review
  • Completed - Merged PRs and closed issues

Development Insights

Code Activity

  • Commit frequency - How often you're making commits
  • Repository focus - Which repositories you work on most
  • Collaboration patterns - How you work with others
  • Code review participation - Your review activity

Project Progress

  • Issue completion - Rate of issue resolution
  • PR velocity - Speed of pull request processing
  • Code quality - Review feedback and merge patterns
  • Team collaboration - Cross-team contributions

Repository Management

Repository Selection

  • Personal repositories - Your own projects and contributions
  • Organization repos - Team and company repositories
  • Public vs private - Support for both public and private repos
  • Fork management - Track work on forked repositories

Access Control

  • Repository permissions - Control which repos are tracked
  • Branch filtering - Focus on specific branches
  • File type filtering - Exclude certain file types from tracking
  • Time-based filtering - Only track recent activity

Integration Features

Real-time Updates

  • Live activity feed - See GitHub activity in real-time
  • Notification sync - GitHub notifications in One Horizon
  • Status updates - Automatic task status updates
  • Progress tracking - Real-time project progress

Cross-platform Sync

  • Task synchronization - GitHub issues as One Horizon tasks
  • Status updates - Update GitHub from One Horizon
  • Comment sync - Sync comments and discussions
  • Label management - Sync GitHub labels with One Horizon tags

Privacy & Security

Data Protection

  • OAuth authentication - Secure, token-based access
  • Minimal data retention - Only store necessary information
  • User control - Easy revocation of access

Repository Privacy

  • Private repo support - Secure handling of private repositories
  • Data isolation - Repository data kept separate
  • Access logging - Track when and how data is accessed
  • Compliance - Meet enterprise security requirements

Best Practices

  • Repository organization - Use consistent naming and structure
  • Label consistency - Standardize GitHub labels
  • Documentation - Keep README files updated