Workspace CLI Skill

Unified CLI interface for all workspace-hub management tools across 26+ repositories.

Quick Start

Launch interactive menu

./scripts/workspace

Direct repository sync

./scripts/repository_sync status all

Quick compliance check

./scripts/compliance/verify_compliance.sh

When to Use

• Starting a work session and need quick access to common tools

• Managing multiple repositories with bulk operations

• Running compliance checks across the workspace

• Accessing development tools and refactoring utilities

• Configuring system settings and remote connections

Prerequisites

• Access to workspace-hub repository

• Bash shell (Linux/macOS/WSL)

• Scripts marked as executable (chmod +x ./scripts/workspace )

Overview

The Workspace CLI provides a unified interface to all workspace-hub management tools. This skill covers navigation, common operations, and integration with other workspace systems.

Direct Script Access

Repository management

./scripts/repository/configure_repos.sh

Compliance tools

./scripts/compliance/verify_compliance.sh

Development tools

./scripts/development/refactor-analysis.sh

System tools

./scripts/system/sync

Main Menu Structure

+================================================================+ | Workspace Hub - Management Console | +================================================================+

Workspace Management:

1. Repository Management

2. Compliance & Standards

3. Remote Connection Tools

4. Development Tools

5. System Setup & Configuration

6. Help & Documentation

7. Exit

Execution Checklist

• Navigate to workspace-hub root directory

• Verify scripts are executable (chmod +x ./scripts/workspace )

• Launch CLI with ./scripts/workspace

• Select appropriate menu category

• Execute required operation

• Verify operation success

• Exit cleanly (option 0)

Category Details

1. Repository Management

Access multi-repository git operations:

Repository Management:

1. Repository Sync Manager # Full git operations menu

2. Configure Repository URLs # Setup GitHub URLs

3. Check All Repository Status # Quick status overview

4. Back to main menu

Common Operations:

List all repositories

./scripts/repository_sync list all

Sync all work repositories

./scripts/repository_sync sync work -m "Update"

Pull latest from all repos

./scripts/repository_sync pull all

Check status

./scripts/repository_sync status all

2. Compliance & Standards

Enforce coding standards and guidelines:

Compliance & Standards:

1. Propagation Tools # Spread standards

2. Compliance Enforcement # Setup and hooks

3. Verification Tools # Check status

4. Back to main menu

Propagation Tools:

Sync CLAUDE.md to all repos

./scripts/compliance/propagate_claude_config.py

Sync AI guidelines

./scripts/compliance/propagate_guidelines.sh

Enable interactive mode

./scripts/compliance/propagate_interactive_mode.sh

Enforcement:

Initial setup

./scripts/compliance/setup_compliance.sh

Install git hooks

./scripts/compliance/install_compliance_hooks.sh

Verify compliance

./scripts/compliance/verify_compliance.sh

3. Remote Connection Tools

Manage remote workspace connections:

Remote Connection Tools:

1. Linux Connection Tools

2. Windows Connection Tools

3. Tailscale Connection Tools

4. Back to main menu

Linux:

./scripts/connection/connect-workspace-linux.sh ./scripts/connection/sync-tabby-linux.sh

Windows:

./scripts/connection/connect-workspace-windows.ps1 ./scripts/connection/sync-tabby-windows.ps1

Tailscale:

./scripts/connection/connect-workspace-tailscale.sh # Bash ./scripts/connection/connect-workspace-tailscale.ps1 # PowerShell

4. Development Tools

AI-powered development and code quality:

Development Tools:

1. Factory.ai Tools # Install Factory.ai

2. Refactor Analysis # Code quality analysis

3. Droid CLI # Factory.ai droid wrapper

4. Back to main menu

Refactor Analysis:

Run full analysis

./scripts/development/refactor-analysis.sh

Output in .refactor-reports/

Analysis includes:

• Code duplication (jscpd)

• Dead code detection (knip)

• Slow test identification

• Large file detection

• Outdated dependencies

Factory.ai:

Install Factory.ai

./scripts/development/install_factory_ai.sh

Use droid CLI

./scripts/development/droid --help

5. System Setup & Configuration

System-level configuration:

System Setup & Configuration:

1. Workspace Sync # Full workspace sync

2. Setup XRDP # Remote desktop

3. View System Information # Workspace stats

4. Back to main menu

Workspace Sync:

./scripts/system/sync

Performs:

• Git repository synchronization

• MCP server installation

• UV environment setup

• NPM package management

• Agent configuration

6. Help & Documentation

Access documentation and help:

Help & Documentation:

1. Repository Sync Documentation

2. View README

3. Available Commands

4. Quick Start Guide

5. Back to main menu

Script Organization

scripts/ +-- workspace # Main CLI entry point | +-- repository/ # Repository management | +-- configure_repos.sh | +-- check_all_status.sh | +-- compliance/ # Compliance tools | +-- propagate_claude_config.py | +-- propagate_guidelines.sh | +-- propagate_interactive_mode.sh | +-- setup_compliance.sh | +-- install_compliance_hooks.sh | +-- verify_compliance.sh | +-- connection/ # Remote connections | +-- connect-workspace-linux.sh | +-- connect-workspace-windows.ps1 | +-- connect-workspace-tailscale.sh | +-- connect-workspace-tailscale.ps1 | +-- sync-tabby-linux.sh | +-- sync-tabby-windows.ps1 | +-- development/ # Development tools | +-- install_factory_ai.sh | +-- refactor-analysis.sh | +-- droid | +-- system/ # System configuration +-- sync +-- setup_xrdp.sh

Common Workflows

Daily Development Start

1. Launch workspace CLI

./scripts/workspace

2. Repository Management -> Repository Sync Manager

3. Navigate to: Pull -> All

Or directly:

./scripts/repository_sync pull all

End of Day Sync

Sync all work with commit message

./scripts/repository_sync sync work -m "$(date +%Y-%m-%d) updates"

Setup New Repository

1. Configure URLs

./scripts/repository/configure_repos.sh

2. Clone repository

./scripts/repository_sync clone <repo-name>

3. Setup compliance

./scripts/compliance/setup_compliance.sh

Code Quality Check

Run refactor analysis

./scripts/development/refactor-analysis.sh

Check compliance

./scripts/compliance/verify_compliance.sh

Propagate Standards

Update all repos with latest standards

./scripts/compliance/propagate_claude_config.py ./scripts/compliance/propagate_guidelines.sh ./scripts/compliance/propagate_interactive_mode.sh

Error Handling

Menu Display Issues

Check terminal supports ANSI

echo $TERM

Run with basic terminal

TERM=xterm ./scripts/workspace

Script Not Found

Verify workspace root

pwd

Should be: /mnt/github/workspace-hub

Make scripts executable

chmod +x ./scripts/workspace chmod +x ./scripts//.sh

Permission Denied

Fix permissions

chmod +x ./scripts/workspace chmod +x ./scripts//.sh chmod +x ./scripts//.py

Configuration Missing

Run configuration helper

./scripts/repository/configure_repos.sh

Or edit directly

nano config/repos.conf

Metrics & Success Criteria

• Navigation Speed: Access any tool in < 3 menu selections

• Script Execution: 100% success rate for available scripts

• Cross-Platform: Works on Linux, macOS, WSL

• Documentation: All menu options have help text

• Error Handling: Clear error messages with recovery steps

Navigation Tips

Keyboard Navigation

• Number keys: Select menu options

• 0: Go back / Exit

• Ctrl+C: Force exit

Direct Access

Skip menus with direct commands:

Instead of navigating menus

./scripts/workspace

Use direct script path

./scripts/repository_sync sync all -m "Quick update"

Command Aliases

Add to .bashrc or .zshrc :

Workspace CLI aliases

alias ws='./scripts/workspace' alias rs='./scripts/repository_sync' alias rsync='./scripts/repository_sync sync all' alias rstatus='./scripts/repository_sync status all' alias rpull='./scripts/repository_sync pull all'

Integration Points

With Repository Sync

The CLI wraps repository_sync for menu access:

Menu access

./scripts/workspace -> 1 -> 1

Direct access

./scripts/repository_sync <command>

With Compliance System

Menu access

./scripts/workspace -> 2 -> 3

Direct access

./scripts/compliance/verify_compliance.sh

With AI Agents

AI agents can use CLI scripts:

Run status check

subprocess.run(['./scripts/repository_sync', 'status', 'all'])

Verify compliance

subprocess.run(['./scripts/compliance/verify_compliance.sh'])

Related Skills

• repo-sync - Repository synchronization

• compliance-check - Compliance verification

• sparc-workflow - Development methodology

Environment Variables

Supported Variables

Default editor for config editing

export EDITOR=vim

Log level

export LOG_LEVEL=INFO

Parallel operations

export PARALLEL_JOBS=4

Configuration File

Location: config/workspace.conf

Workspace configuration

DEFAULT_SYNC_MESSAGE="Workspace sync" PARALLEL_ENABLED=true MAX_PARALLEL_JOBS=4

References

• WORKSPACE_CLI.md

• REPOSITORY_SYNC.md

• CLI_MENU_STRUCTURE.md

Version History

• 1.1.0 (2026-01-02): Upgraded to SKILL_TEMPLATE_v2 format - added When to Use, Execution Checklist, Error Handling consolidation, Metrics, Integration Points

• 1.0.0 (2024-10-15): Initial release with 6 main categories, script organization, workflows, navigation, troubleshooting