glab-repo

glab repo

管理 GitLab 仓库和项目。

快速入门

# Clone a repository
glab repo clone group/project

# Create new repository
glab repo create my-new-project --public

# Fork a repository
glab repo fork upstream/project

# View repository details
glab repo view

# Search for repositories
glab repo search "keyword"

常用工作流

创建新项目

1. 创建仓库：

   glab repo create my-project \
     --public \
     --description "My awesome project"
   

2. 克隆到本地：

   glab repo clone my-username/my-project
   cd my-project
   

3. 初始化内容：

   echo "# My Project" > README.md
   git add README.md
   git commit -m "Initial commit"
   git push -u origin main
   

Fork 工作流

1. Fork 上游仓库：

   glab repo fork upstream-group/project
   

2. 克隆你的 Fork：

   glab repo clone my-username/project
   cd project
   

3. 添加上游远程仓库：

   git remote add upstream https://gitlab.com/upstream-group/project.git
   

4. 保持 Fork 同步：

   git fetch upstream
   git merge upstream/main
   

自动同步：

使用同步脚本一键更新 Fork：

scripts/sync-fork.sh main
scripts/sync-fork.sh develop upstream

该脚本自动完成：拉取 → 合并 → 推送到 origin。

仓库管理

查看仓库信息：

glab repo view
glab repo view group/project  # Specific repo
glab repo view --web          # Open in browser

更新仓库设置：

glab repo update \
  --description "Updated description" \
  --default-branch develop

归档仓库：

glab repo archive download main  # Downloads .tar.gz
glab repo archive download main --format zip

转移到新命名空间：

glab repo transfer my-project --target-namespace new-group

删除仓库：

glab repo delete group/project

成员管理

列出协作者：

glab repo members list

添加成员：

glab repo members add @username --access-level maintainer

移除成员：

glab repo members remove @username

更新成员权限：

glab repo members update @username --access-level developer