---

name: glab-repo description: 管理 GitLab 仓库和项目，包括克隆、创建、Fork、归档、查看、更新、删除、搜索、转移和成员管理。适用于管理仓库生命周期、Fork 项目、克隆仓库、搜索项目、管理协作者或配置仓库设置等场景。触发关键词：repository、repo、project、clone、fork、创建仓库、搜索项目、协作者。

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

批量操作

克隆群组中所有仓库：

glab repo clone -g my-group

搜索并克隆：

glab repo search "api" --per-page 10
# Then clone specific result
glab repo clone group/api-project

列出你的仓库：

glab repo list
glab repo list --member          # Only where you're a member
glab repo list --mine            # Only repos you own

故障排除

克隆失败（权限错误）：

• 验证是否有访问权限：glab repo view group/project
• 检查认证状态：glab auth status
• 对于私有仓库，确保使用正确的账户登录

Fork 操作失败：

• 检查你的命名空间中是否已存在相同的 Fork
• 确认你有 Fork 权限（部分仓库禁用了 Fork 功能）
• 尝试指定路径：glab repo fork --fork-path username/new-name

转移失败：

• 确认你有 Owner/Maintainer 权限
• 检查目标命名空间是否存在且你有创建权限
• 部分项目可能启用了转移保护

群组克隆失败：

• 确认群组存在且你有访问权限
• 检查是否有足够的磁盘空间
• 大型群组可能会超时 —— 建议逐个克隆特定仓库

相关技能

认证与访问：

• 参见 glab-auth 了解登录和认证设置
• 参见 glab-ssh-key 了解 SSH 密钥管理
• 参见 glab-deploy-key 了解部署认证

项目配置：

• 参见 glab-config 了解 CLI 默认设置
• 参见 glab-variable 了解 CI/CD 变量

Fork 同步：

• 脚本：scripts/sync-fork.sh 自动化上游同步

命令参考

完整的命令文档和所有参数请参见 references/commands.md。

可用命令：

• clone - 克隆仓库或群组
• create - 创建新项目
• fork - Fork 仓库
• view - 查看项目详情
• update - 更新项目设置
• delete - 删除项目
• search - 搜索项目
• list - 列出仓库
• transfer - 转移到新命名空间
• archive - 下载仓库归档
• contributors - 列出贡献者
• members - 管理项目成员
• mirror - 配置仓库镜像
• publish - 发布项目资源