A powerful desktop application for managing GitHub repositories with intelligent synchronization, and comprehensive visual management tools.
By using this software, you agree to the full disclaimer terms.
Summary: Software provided "AS IS" without warranty. You assume all risks.
Full legal disclaimer: See DISCLAIMER.md
Smart Repository Manager GUI provides a complete visual interface for managing your GitHub repositories.
Key Benefits:
- Visual Management: Full graphical interface for all operations
- Smart Table: Lazy-loading repository list with filtering and search
- Multi-User Support: Switching between GitHub accounts
- Keyboard-Driven: Complete keyboard shortcuts for power users
Every session begins with an 8-step mandatory system checkup:
- Directory Structure - Creates and verifies workspace organization
- Internet Connection - Validates network connectivity
- User Management - Select or add GitHub account
- User Data - Fetches GitHub profile information
- Repository Loading - Retrieves complete repository list
- Local Copy Check - Scans for existing local repositories
- Update Detection - Identifies repositories needing updates
Complete bidirectional sync - clones missing repositories and updates existing ones.
Smart update detection - only pulls repositories with new commits.
Selective cloning - cloning only repositories not present locally.
Advanced recovery - detects and fixes corrupted repositories, then syncs.
Complete refresh - removes and re-clones all local repositories.
Complete parallel download - download all repositories as ZIP archives.
Live Console: Every sync operation displays real-time logs with timestamp, status, and duration for each repository.
- Lazy Loading: Loads 20 repositories at a time for optimal performance
- Smart Filtering: Filter by Local/Remote, Needs Update, Private/Public, Forks, Archived
- Instant Search: Real-time filtering by name, description, or language
- Visual Indicators: Status icons for local presence and update requirements
- Context Menu: Right-click actions for quick operations
| Panel | Information Displayed |
|---|---|
| Token | Token validity, API limits (remaining/total), reset time |
| Repositories | Total count, local copies, pending updates |
| User | Display name, public repos, followers count |
| Network | Connection status, external IP, GitHub accessibility |
- User Information - Complete GitHub profile with avatar
- Token Information - Token scopes, creation date, rate limits
- Network Information - DNS, server responses, connection quality
- Storage Management - Disk usage, cleanup tools, repository details
| Shortcut | Action |
|---|---|
Ctrl+B |
Create Archive |
F5 |
Refresh |
Ctrl+Q |
Exit |
| Shortcut | Action |
|---|---|
Ctrl+S |
Synchronize All |
Ctrl+U |
Update Needed Only |
Ctrl+M |
Clone Missing Only |
Ctrl+Shift+R |
Sync with Repair |
Ctrl+Alt+R |
Re-clone All Repositories |
Ctrl+Shift+S |
Sync Selected |
Ctrl+Shift+C |
Clone Selected |
Ctrl+Shift+U |
Update Selected |
Ctrl+Shift+D |
Download all repositories |
| Shortcut | Action |
|---|---|
Ctrl+Shift+B |
Open in Browser |
Ctrl+L |
Open Local Folder |
Ctrl+D |
Show Details |
Ctrl+R |
Refresh List |
Ctrl+Del |
Delete Local Copy |
| Shortcut | Action |
|---|---|
Ctrl+I |
User Information |
Ctrl+T |
Token Information |
Ctrl+Shift+N |
Network Information |
Ctrl+Shift+M |
Storage Management |
| Shortcut | Action |
|---|---|
F1 |
Documentation |
Ctrl+/ |
Keyboard shortcuts |
Ctrl+Shift+A |
About |
- Add Users: Quick token validation and GitHub profile fetch
- Switch Users: Instant context switching with visual feedback
- Delete Users: Complete removal of user data and tokens
- Avatar Support: Automatic avatar download and circular display
- Persistent Storage: Token storage per user
- Python 3.8+
- Git installed and configured
- GitHub Personal Access Token (with
reposcope) - PyQt6
- Visit GitHub Tokens
- Select permissions:
repo(full repository access)
- Generate and copy token
After that, install and run the application:
# Clone repository
git clone https://github.com/smartlegionlab/smart-repository-manager-gui.git
# Go to project folder
cd smart-repository-manager-gui/
# Create virtual environment
python -m venv venv
# Activate virtual environment
source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Launch application
python app.py~/smart_repository_manager/
├── config.json # Multi-user configuration
├── username_1/ # User-specific directories
│ ├── repositories/ # Local Git repositories
│ ├── archives/ # ZIP backups
│ ├── downloads/ # Downloaded repositories as ZIP archives
│ ├── logs/ # Operation logs
│ ├── backups/ # Manual backups
│ ├── temp/ # Temporary files
│ └── avatar.png # GitHub profile picture
└── username_2/ # Additional users
- Local-Only: All operations performed locally with GitHub API
- No Telemetry: No data is sent to external servers
- No Account Linking: Your GitHub account is not linked to any external service
This GUI application is powered by the same core engine as:
A Python library for managing Git repositories with intelligent synchronization, SSH configuration validation, and GitHub integration. This library serves as the foundation for both CLI and GUI implementations.
A comprehensive command-line tool for users who prefer terminal-based workflows. Offers identical functionality in a text-based interface.
ACTIVE DEVELOPMENT - This project is under continuous development. While we strive for stability, you may encounter:
- Interface changes between versions
- New features in active testing
- Performance optimizations in progress
- Documentation updates pending
Recommended for: Development environments, personal use, testing Not recommended for: Critical production systems without thorough testing
- Bug Reports: Please include system information, steps to reproduce, and error logs
- Feature Requests: Describe the use case and expected behavior
- Questions: Check existing issues before creating new ones
- Fork the repository
- Create a feature branch
- Follow existing code style
- Submit pull request with clear description
BSD 3-Clause License - See LICENSE file for details.
Copyright © 2026, Alexander Suvorov. All rights reserved.
Alexander Suvorov
- GitHub: @smartlegionlab
- Email: smartlegionlab@gmail.com
Smart Repository Manager GUI - Visual control for your GitHub universe.
