AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它提供了一个全面的GUI工具，涵盖仓库生命周期管理，包括AI辅助描述和删除前的完整备份，解决了拥有大量仓库的开发者的常见痛点。

适合谁使用

拥有大量GitHub仓库的开发者
开源项目维护者
管理课程或实验仓库的学生或教师
需要清理或归档仓库的组织

典型使用场景

清理旧或不用的仓库
删除前归档仓库
批量重命名或更改仓库可见性
创建包含Issues和PR的完整备份

项目优势

跨平台（Windows/macOS/Linux）基于PySide6
支持多种认证方式（PAT、GitHub CLI、OAuth）
完整备份包括git镜像和元数据（Issues、PRs、里程碑）
AI辅助描述生成和双列活动/归档仓库界面

使用前须知

需要具有适当权限的GitHub令牌
删除和重命名操作不可逆
本地需安装Git才能进行完整分支备份
没有自动CI/CD打包，需本地用PyInstaller构建

README 快速开始

RepoManager

수업·실습 후 남는 GitHub 저장소를 GUI에서 골라 백업·아카이브·이름 변경·삭제하는 데스크톱 앱입니다.
Windows, macOS, Linux에서 동작합니다 (PySide6).

프로젝트: https://github.com/progh2/repomanager

기능

목록·필터

활성 / 아카이브 이중 목록과 → ← 이동
검색, Owner, 공개범위, Pages, Fork, 정렬(이름 / 업데이트 / 생성)
생성일·업데이트일, Public/Private, 설명, Pages·Fork 아이콘
더블클릭 또는 버튼으로 GitHub / Pages 열기
로딩 스피너 오버레이, 시작 시 캐시 목록 즉시 표시 후 백그라운드 새로고침
창 크기·필터·정렬 상태 기억

편집·정리

설명 편집, AI 추천 설명(GitHub Models / Copilot 권한 시, UI 언어로 생성)
공개/비공개 토글
이름 변경 — URL·remote·Pages 등이 깨질 수 있다는 경고 + RENAME 입력 확인
선택 저장소 일괄 아카이브 / 활성 복원 / 삭제
삭제·이름 변경 전 확인 창 (DELETE / RENAME 입력)
삭제 전 CSV 내보내기, ZIP 백업

ZIP 백업 (삭제 전 권장)

git clone --mirror로 모든 브랜치·태그 포함
Issues / Pull requests / Milestones를 JSON으로 함께 저장
상세 패널, 상단 ZIP 백업, 삭제 확인 창에서 실행
로컬에 Git이 없으면 메타데이터만 저장하고 안내

인증·설정·UX

PAT / GitHub CLI / 웹 로그인(OAuth Device Flow)
토큰은 OS 자격 증명 저장소(keyring)에 저장
다국어 UI: 한국어 / English / 日本語 (시스템 기본)
라이트 / 다크 테마
단축키: F5·Ctrl+R 새로고침, Delete 삭제 확인
API rate limit 표시, 백그라운드 워커로 UI 멈춤 방지

요구 사항

Python 3.11+
GitHub 토큰 (PAT 또는 gh / OAuth)
ZIP 전체 브랜치 백업 시: Git이 PATH에 있어야 함

빠른 실행 (권장)

# Windows — 더블클릭 또는 터미널
run.bat

# macOS / Linux
./run.sh

첫 실행 시 .venv 생성과 의존성 설치를 자동으로 합니다.
의존성만 다시 설치: run.bat --update / ./run.sh --update

수동 설치·실행

python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

pip install -r requirements.txt
# 또는: pip install -e ".[dev]"

python -m repomanager

선택적으로 .env에 토큰을 둘 수 있습니다 (copy / cp .env.example .env).

GITHUB_TOKEN=ghp_your_token_here
GITHUB_OAUTH_CLIENT_ID=Iv1...   # 웹 로그인용(선택)

GitHub 인증

우선순위: 환경변수(.env) → 설정에 저장한 토큰 → GitHub CLI(gh).

1) 설정 메뉴 (권장)

파일 → 설정 (Ctrl+,)

Personal Access Token 붙여넣기 후 저장
또는 GitHub CLI에서 가져오기
또는 GitHub 웹으로 로그인 (OAuth Device Flow)

토큰은 Windows Credential Manager / macOS Keychain / Linux Secret Service에 keyring으로 저장됩니다.
keyring을 쓸 수 없으면 Qt QSettings로 대체됩니다.

2) Classic PAT 권한

작업	필요 권한
목록·아카이브·설명·이름 변경	`repo`
삭제	`delete_repo` (별도)
조직 저장소	`read:org` (필요 시)

Fine-grained PAT는 대상 저장소에 Administration: Read and write(삭제·이름 변경 등)가 필요할 수 있습니다.

3) GitHub CLI로 삭제 권한

gh auth refresh -h github.com -s delete_repo
``

项目描述

Desktop GUI to list, archive, and delete GitHub repositories in bulk (PySide6)

repomanager