Skip to content

Features.md

Latest commit

 

History

History
55 lines (45 loc) · 3.35 KB

Features.md

File metadata and controls

55 lines (45 loc) · 3.35 KB

Features

gh-manager-cli provides a comprehensive set of features for managing your GitHub repositories:

Core Repository Management

  • Token Authentication: Secure PAT storage with validation and persistence
  • Repository Listing: Browse all your personal repositories with metadata (stars, forks, language, etc.)
  • Live Pagination: Infinite scroll with automatic page prefetching
  • Interactive Sorting: Modal-based sort selection (updated, pushed, name, stars) with direction toggle
  • Smart Search: Server-side search through repository names and descriptions (3+ characters)
  • Visibility Filtering: Modal-based visibility filter (All, Public, Private/Internal for enterprise) with smart filtering
  • Fork Status Tracking: Always shows commits behind upstream for forked repositories
  • Stars Mode: View and manage starred repositories (personal account only)
  • Repository Actions:
    • View detailed info (I) - Shows repository metadata, language, size, and timestamps
    • Open in browser (Enter/O)
    • Delete repository (Del or Backspace) with secure two-step confirmation
    • Archive/unarchive repositories (Ctrl+A) with confirmation prompts
    • Change repository visibility (Ctrl+V) - Switch between Public, Private, and Internal (enterprise only)
    • Star/unstar repositories (Ctrl+S) - Toggle star status for any repository
    • Sync forks with upstream (Ctrl+F) with automatic conflict detection
    • Rename repository (Ctrl+R) with inline validation
    • Copy repository URL to clipboard (C) with SSH/HTTPS options

User Interface & Experience

  • Keyboard Navigation: Full keyboard control (arrow keys, PageUp/Down, Ctrl+G/G)
  • Display Density: Toggle between compact/cozy/comfy spacing (T)
  • Visual Indicators: Fork status, private/internal/archived badges, language colors, visibility status
  • Enterprise Support: Full support for GitHub Enterprise with Internal repository visibility
  • Organization Context: Switch between personal and organization accounts with ENT badge for enterprise orgs
  • Interactive Modals: Sort selection, visibility filtering, organization switching, and visibility change dialogs
  • Balanced Layout: Repository items with spacing above and below for better visual hierarchy
  • Loading States: Contextual loading screens for sorting and refreshing operations
  • Rate Limit Monitoring: Live API usage display with visual warnings
  • Improved Layout: Balanced spacing above and below repository items for better visual hierarchy

Technical Features

  • Preference Persistence: UI settings (sort, density, visibility filter, fork tracking) saved between sessions
  • Server-side Filtering: Visibility filtering performed at GitHub API level for accurate pagination
  • Cross-platform: Works on macOS, Linux, and Windows
  • Secure Storage: Token stored with proper file permissions (0600)
  • Error Handling: Graceful error recovery with retry mechanisms
  • Performance: Efficient GraphQL queries with virtualized rendering and server-side filtering
  • Apollo Cache: Built-in caching to reduce API calls and improve performance

Related Pages