workspace-cli

用途

Workspace CLI 是 workspace-hub 的统一命令行界面，为所有 workspace-hub 管理工具提供单一入口，覆盖 26 个以上仓库。它既可以通过交互式菜单导航，也可以直接调用具体脚本，用于仓库管理、合规检查、开发工具使用和系统配置。

主要能力

1. 仓库管理

提供多仓库 Git 操作，包括仓库同步管理器、配置仓库 URL、检查所有仓库状态。常用命令如列出所有仓库、同步所有工作仓库、拉取所有仓库最新代码、检查状态。

2. 合规与标准

强制执行编码标准和指南，包括传播工具（将 CLAUDE.md、AI 指南、交互模式同步到所有仓库）、合规强制执行（初始设置、安装 Git 钩子）、验证工具（检查合规状态）。

3. 远程连接工具

管理远程工作区连接，支持 Linux、Windows 和 Tailscale 三种方式，提供对应的连接脚本和 Tabby 同步脚本。

4. 开发工具

提供 AI 驱动的开发与代码质量工具，包括 Factory.ai 工具安装、重构分析（检测代码重复、死代码、慢测试、大文件、过时依赖，输出到 .refactor-reports/）、Droid CLI 包装器。

5. 系统设置与配置

系统级配置，包括完整工作区同步（Git 仓库同步、MCP 服务器安装、UV 环境设置、NPM 包管理、Agent 配置）、设置 XRDP 远程桌面、查看系统信息。

6. 帮助与文档

访问文档和帮助，包括仓库同步文档、README、可用命令、快速入门指南。

使用方式

快速开始

启动交互式菜单：./scripts/workspace 直接仓库同步：./scripts/repository_sync status all 快速合规检查：./scripts/compliance/verify_compliance.sh

前置条件

可访问 workspace-hub 仓库
Bash shell（Linux/macOS/WSL）
脚本标记为可执行（chmod +x ./scripts/workspace）

直接脚本访问

仓库管理：./scripts/repository/configure_repos.sh
合规工具：./scripts/compliance/verify_compliance.sh
开发工具：./scripts/development/refactor-analysis.sh
系统工具：./scripts/system/sync

主菜单结构

菜单包含六个类别：仓库管理、合规与标准、远程连接工具、开发工具、系统设置与配置、帮助与文档，以及退出选项。

执行检查清单

导航到 workspace-hub 根目录
验证脚本可执行（chmod +x ./scripts/workspace）
启动 CLI：./scripts/workspace
选择适当的菜单类别
执行所需操作
验证操作成功
干净退出（选项 0）

常用工作流

每日开发开始：启动 CLI，进入仓库管理 -> 仓库同步管理器 -> 拉取 -> 全部；或直接 ./scripts/repository_sync pull all
日终同步：./scripts/repository_sync sync work -m "$(date +%Y-%m-%d) updates"
设置新仓库：配置 URL、克隆仓库、设置合规
代码质量检查：运行重构分析、检查合规
传播标准：更新所有仓库的最新标准

导航技巧

数字键选择菜单选项，0 返回/退出，Ctrl+C 强制退出
可直接使用脚本路径跳过菜单
可在 .bashrc 或 .zshrc 中添加别名，如 alias ws='./scripts/workspace'、alias rs='./scripts/repository_sync' 等

环境变量

支持 EDITOR（默认编辑器）、LOG_LEVEL（日志级别）、PARALLEL_JOBS（并行操作数）。配置文件位于 config/workspace.conf。

适用场景

开始工作会话时需要快速访问常用工具
使用批量操作管理多个仓库
在工作区中运行合规检查
访问开发工具和重构实用程序
配置系统设置和远程连接
AI Agent 可通过子进程调用 CLI 脚本执行状态检查或合规验证

限制

需要访问 workspace-hub 仓库
需要 Bash shell（Linux/macOS/WSL）
脚本需要可执行权限
菜单显示可能受终端 ANSI 支持影响，可尝试 TERM=xterm ./scripts/workspace
配置缺失时需运行配置助手或直接编辑 config/repos.conf
具体收费、价格、平台支持范围等未在资料中提供