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

  0) 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

  0) 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

  0) 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

  0) 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

  0) 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

  0) 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

  0) 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

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

workspace-cli

Workspace CLI Skill

Quick Start

When to Use

More from vamseeachanta/workspace-hub

echarts

gis

pandoc

mkdocs

cli-productivity

python-docx