xaostech · Nov 13, 2026 · Nov 13, 2026
diff --git a/commands/config.sh b/commands/config.sh
@@ -23,20 +23,11 @@ show_help() {
 Dev-Control Configuration Manager
 
 USAGE:
-  dc config                    Show current configuration
-  dc config get <key>          Get a specific value
-  dc config set <key> <value>  Set a value (project scope)
-  dc config set --global <key> <value>  Set globally
-  dc config edit               Open config in editor
-  dc config init               Initialise project config
+dc config                    Show current configuration dc config get <key>          Get a specific value dc config set <key> <value>  Set a value (project scope) dc config set --global <key> <value>  Set globally dc config edit               Open config in editor dc config init               Initialise project config
 
 KEYS:
-  default-licence       Default licence (MIT, GPL-3.0, etc.)
-  default-branch        Default branch name
-  auto-sign-commits     Sign commits with GPG (true/false)
-  auto-push-after-fix   Push after history fix (true/false)
-  github-org            Default GitHub organisation
-  template-set          Template set (default/minimal/full)
+default-licence       Default licence (MIT, GPL-3.0, etc.) default-branch        Default branch name
+auto-sign-commits     Sign commits with GPG (true/false) auto-push-after-fix   Push after history fix (true/false) github-org            Default GitHub organisation template-set          Template set (default/minimal/full)
 
 EXAMPLES:
   dc config

diff --git a/commands/version.sh b/commands/version.sh
@@ -81,8 +81,7 @@ USAGE:
   dc version [COMMAND] [OPTIONS]
 
 COMMANDS:
-  show            Show version information (default)
-  check           Check for updates
+show            Show version information (default) check           Check for updates
   update          Update to latest version
   changelog       Show recent changes
 
@@ -96,8 +95,7 @@ EXAMPLES:
   dc version --json         # JSON output
   dc version check          # Check for updates
   dc version update         # Perform update
-  dc version changelog      # Show recent changes
-  dc version changelog 1.0.0  # Show specific version
+dc version changelog      # Show recent changes dc version changelog 1.0.0  # Show specific version
 
 EOF
 }

diff --git a/scripts/containerise.sh b/scripts/containerise.sh
@@ -66,9 +66,7 @@ show_help() {
 Dev-Control Containerisation - Build base images or generate devcontainers
 
 USAGE:
-  containerise.sh --base --CATEGORY     # Build a base image
-  containerise.sh --img --CATEGORY      # Generate devcontainer using base image
-  containerise.sh [PROJECT_PATH]        # Interactive mode (legacy)
+containerise.sh --base --CATEGORY     # Build a base image containerise.sh --img --CATEGORY      # Generate devcontainer using base image containerise.sh [PROJECT_PATH]        # Interactive mode (legacy)
 
 MODES:
   --base    Build a category base image (e.g., devcontrol/game-dev:latest)
@@ -95,19 +93,16 @@ CATEGORIES:
 
 EXAMPLES:
   # Build base images
-  cd ~/.dev-control/.devcontainer && containerise.sh --base --game-dev
-  cd ~/projects/streaming && containerise.sh --base --streaming
+  cd ~/.dev-control/.devcontainer && containerise.sh --base --game-dev cd ~/projects/streaming && containerise.sh --base --streaming
 
   # Generate devcontainers
-  cd ~/projects/my-game && containerise.sh --img --game-dev
-  cd ~/projects/web-app && containerise.sh --img --web-dev
+  cd ~/projects/my-game && containerise.sh --img --game-dev cd ~/projects/web-app && containerise.sh --img --web-dev
 
   # Rebuild all containers in a project tree
   cd ~/PRO && containerise.sh --nest
 
   # Rebuild only dev-tools containers (base + img) in a project tree
-  cd ~/PRO && containerise.sh --nest --dev-tools
-  cd ~/PRO && containerise.sh --nest --regen --dev-tools
+  cd ~/PRO && containerise.sh --nest --dev-tools cd ~/PRO && containerise.sh --nest --regen --dev-tools
 
   # Rebuild multiple categories at once
   cd ~/PRO && containerise.sh --nest --web-dev --streaming

diff --git a/scripts/create-repo.sh b/scripts/create-repo.sh
@@ -94,9 +94,7 @@ OPTIONS:
   -h, --help             Show this help
 
 EXAMPLES:
-  create-repo.sh                       # Create repo for current directory
-  create-repo.sh --edit topics         # Edit topics only
-  create-repo.sh --batch dir1 dir2     # Create repos for multiple dirs
+create-repo.sh                       # Create repo for current directory create-repo.sh --edit topics         # Edit topics only create-repo.sh --batch dir1 dir2     # Create repos for multiple dirs
 
 ALIASES:
   dc-repo, dc-create

diff --git a/scripts/dev-control.sh b/scripts/dev-control.sh
@@ -171,20 +171,8 @@ USAGE:
   dev-control.sh [COMMAND] [OPTIONS]
 
 COMMANDS:
-  alias, aliases     Install bash aliases (dc-aliases)
-  git                Git services menu (dc-git) - unified git workflows
-  init, template     Initialise repo with templates (dc-init)
-  repo, create       Create GitHub repository (dc-repo)
-  pr                 Create pull request (dc-pr)
-  modules, nest      Manage submodules (dc-modules)
-  fix, history       Fix commit history (dc-fix)
-  full-fix, ff       Dedup + GPG-sign recent commits, then optionally refresh templates (dc-full-fix)
-  licences, lic      Audit licences (dc-licences)
-  package, pkg       Build multi-platform packages (dc-package)
-  mcp                Setup MCP servers (dc-mcp)
-  cluster            Setup fully fledged cluster (init + container + mcp)
-  container          Setup devcontainer (dc-container)
-  help               Show this help message
+alias, aliases     Install bash aliases (dc-aliases) git                Git services menu (dc-git) - unified git workflows init, template     Initialise repo with templates (dc-init) repo, create       Create GitHub repository (dc-repo) pr                 Create pull request (dc-pr) modules, nest      Manage submodules (dc-modules) fix, history       Fix commit history (dc-fix) full-fix, ff       Dedup + GPG-sign recent commits, then optionally refresh templates (dc-full-fix) licences, lic      Audit licences (dc-licences) package, pkg       Build multi-platform packages (dc-package) mcp                Setup MCP servers (dc-mcp)
+cluster            Setup fully fledged cluster (init + container + mcp) container          Setup devcontainer (dc-container) help               Show this help message
 
 INTERACTIVE MODE:
   Run without arguments to use the interactive menu.

diff --git a/scripts/git-control.sh b/scripts/git-control.sh
@@ -98,16 +98,7 @@ WORKFLOW EXAMPLE:
   4. Create pull request:      git-control pr
 
 EXAMPLES:
-  git-control.sh                         # Interactive menu
-  git-control.sh init                    # Initialise templates
-  git-control.sh init --batch -y         # Batch init multiple repos
-  git-control.sh repo                    # Create repository
-  git-control.sh pr                      # Create pull request
-  git-control.sh fix --range HEAD=5      # Fix last 5 commits
-  git-control.sh fix --sign --dry-run    # Preview signing commits
-  git-control.sh licences --deep         # Deep licence scan
-  git-control.sh licences --apply MIT    # Apply MIT licence
-  git-control.sh gpg-setup               # Setup GPG bot for Actions
+git-control.sh                         # Interactive menu git-control.sh init                    # Initialise templates git-control.sh init --batch -y         # Batch init multiple repos git-control.sh repo                    # Create repository git-control.sh pr                      # Create pull request git-control.sh fix --range HEAD=5      # Fix last 5 commits git-control.sh fix --sign --dry-run    # Preview signing commits git-control.sh licences --deep         # Deep licence scan git-control.sh licences --apply MIT    # Apply MIT licence git-control.sh gpg-setup               # Setup GPG bot for Actions
 
 ALIASES (after running dc-aliases):
   dc-git         - This unified wrapper

diff --git a/scripts/lib/git/rename.sh b/scripts/lib/git/rename.sh
@@ -42,9 +42,7 @@ main() {
 Branch Renaming Tool - Rename branches or repositories
 
 USAGE:
-  rename.sh [OPTIONS] [OWNER] [BRANCH_SPEC] [PATHS...]
-  rename.sh --branch [SPEC]    # Rename a branch
-  rename.sh --repo NEW_NAME    # Rename the GitHub repository
+rename.sh [OPTIONS] [OWNER] [BRANCH_SPEC] [PATHS...] rename.sh --branch [SPEC]    # Rename a branch rename.sh --repo NEW_NAME    # Rename the GitHub repository
 
 ARGUMENTS:
   OWNER         GitHub user/org (default: current gh user)
@@ -61,11 +59,7 @@ OPTIONS:
   -h, --help        Show this help
 
 EXAMPLES:
-  dc fix rename --branch main              # Rename default branch to main
-  dc fix rename --repo modern-dating       # Rename repo on GitHub + update remote
-  dc fix rename Main:main ~/repos/*        # Local repos, explicit spec
-  rename.sh -n xaoscience Main:main        # Dry run
-  rename.sh "" Main:main ~/proj1 ~/proj2   # Multiple local repos
+dc fix rename --branch main              # Rename default branch to main dc fix rename --repo modern-dating       # Rename repo on GitHub + update remote dc fix rename Main:main ~/repos/*        # Local repos, explicit spec rename.sh -n xaoscience Main:main        # Dry run rename.sh "" Main:main ~/proj1 ~/proj2   # Multiple local repos
 
 NOTES:
   - --repo renames on GitHub and updates the local remote.origin URL

diff --git a/scripts/lib/keygen.sh b/scripts/lib/keygen.sh
@@ -363,13 +363,7 @@ dc-key — unified GPG identity & repo-secret manager
 
 USAGE:
   dc-key                 Interactive menu
-  dc-key --user          Personal signing key: generate, enrol, cache
-  dc-key --bot           Refresh machine/bot repo secrets (GPG private key + passphrase)
-  dc-key --token         Set / rotate the user token (PAT) repo secret
-  dc-key --status        Show key/secret status (read-only; values are never shown)
-  dc-key --dry-run       Report actions without making changes
-  dc-key --force         Override idempotency guards (rotate even if current)
-  dc-key --help          This help
+dc-key --user          Personal signing key: generate, enrol, cache dc-key --bot           Refresh machine/bot repo secrets (GPG private key + passphrase) dc-key --token         Set / rotate the user token (PAT) repo secret dc-key --status        Show key/secret status (read-only; values are never shown) dc-key --dry-run       Report actions without making changes dc-key --force         Override idempotency guards (rotate even if current) dc-key --help          This help
 
 All secret names are resolved from config/profiles/repoVars.env; nothing is hardcoded.
 EOF

diff --git a/scripts/licences.sh b/scripts/licences.sh
@@ -58,12 +58,7 @@ OPTIONS:
   -h, --help              Show this help message
 
 EXAMPLES:
-  licences.sh                           # Show licence for current repo
-  licences.sh --deep                    # Include all submodules
-  licences.sh --json --deep             # JSON output with submodules
-  licences.sh --check GPL-3.0           # Check if deps are compatible with GPL-3.0
-  licences.sh --apply MIT               # Apply MIT licence template
-  licences.sh /path/to/repo --deep      # Scan specific directory
+licences.sh                           # Show licence for current repo licences.sh --deep                    # Include all submodules licences.sh --json --deep             # JSON output with submodules licences.sh --check GPL-3.0           # Check if deps are compatible with GPL-3.0 licences.sh --apply MIT               # Apply MIT licence template licences.sh /path/to/repo --deep      # Scan specific directory
 
 OUTPUT:
   Default output shows a table with:

diff --git a/scripts/mcp-setup.sh b/scripts/mcp-setup.sh
@@ -136,8 +136,7 @@ TOKEN MANAGEMENT:
   2. Optionally copied to clipboard (for easy pasting in VS Code)
   3. Displayed once (save it if you skip keyring/clipboard)
 
-  VS Code will prompt for the token on first MCP use and store it in
-  its secure credential vault automatically.
+  VS Code will prompt for the token on first MCP use and store it in its secure credential vault automatically.
 
   Storage options:
   1. VS Code Secure Vault (automatic after first prompt) - Most secure
@@ -146,11 +145,7 @@ TOKEN MANAGEMENT:
   4. GitHub CLI (gh auth token) - For testing/development
 
 EXAMPLES:
-  mcp-setup.sh               # Full setup with VS Code secure input
-  mcp-setup.sh --create-pat  # Create PAT + store in keyring (recommended)
-  mcp-setup.sh --test        # Test existing configuration
-  mcp-setup.sh --show-token  # Retrieve token from keyring/gh
-  mcp-setup.sh --config-only # Just create config file
+mcp-setup.sh               # Full setup with VS Code secure input mcp-setup.sh --create-pat  # Create PAT + store in keyring (recommended) mcp-setup.sh --test        # Test existing configuration mcp-setup.sh --show-token  # Retrieve token from keyring/gh mcp-setup.sh --config-only # Just create config file
 
 ALIASES:
   dc-mcp

diff --git a/scripts/module-nesting.sh b/scripts/module-nesting.sh
@@ -1384,11 +1384,7 @@ Options:
   -h, --help           Show this help
 
 Examples:
-  module-nesting.sh                          # Interactive: scan and update .gitmodules
-  module-nesting.sh /path/to/monorepo        # Scan a specific root directory
-  module-nesting.sh --copy-temp --dry-run    # Preview temp-dir consolidation
-  module-nesting.sh --aggressive --delete    # Consolidate + delete originals
-  module-nesting.sh --prune                  # Clean up stale consolidation records
+module-nesting.sh                          # Interactive: scan and update .gitmodules module-nesting.sh /path/to/monorepo        # Scan a specific root directory module-nesting.sh --copy-temp --dry-run    # Preview temp-dir consolidation module-nesting.sh --aggressive --delete    # Consolidate + delete originals module-nesting.sh --prune                  # Clean up stale consolidation records
 
 Aliases: dc-modules, dc-nest
 HELP

diff --git a/scripts/packaging.sh b/scripts/packaging.sh
@@ -111,17 +111,10 @@ OPTIONS:
   -h, --help            Show this help message
 
 THEMES:
-  matrix                Green fluorescent terminal aesthetic
-  hacker                Orange/amber retro hacker style
-  cyber                 Blue cyberpunk neon look
+matrix                Green fluorescent terminal aesthetic hacker                Orange/amber retro hacker style cyber                 Blue cyberpunk neon look
 
 EXAMPLES:
-  packaging.sh --init                    # Create config file
-  packaging.sh --tarball --homebrew      # Build tarball + Homebrew
-  packaging.sh --all                     # Build everything
-  packaging.sh --snap --verbose          # Build snap with details
-  packaging.sh --docker                  # Build Docker image
-  packaging.sh --theme cyber --all       # Build all with cyber theme
+packaging.sh --init                    # Create config file packaging.sh --tarball --homebrew      # Build tarball + Homebrew packaging.sh --all                     # Build everything packaging.sh --snap --verbose          # Build snap with details packaging.sh --docker                  # Build Docker image packaging.sh --theme cyber --all       # Build all with cyber theme
 
 CONFIG FILE (.dc-package.yaml):
   name: my-tool

diff --git a/scripts/template-loading.sh b/scripts/template-loading.sh
@@ -1428,8 +1428,7 @@ run_batch_update() {
     done
 
     if [[ ${#git_dirs[@]} -eq 0 ]]; then
-        # If the user passed explicit paths that all lacked .git (likely a glob expansion like *),
-        # offer to fall back to the current directory before giving up.
+        # If the user passed explicit paths that all lacked .git (likely a glob expansion like *), offer to fall back to the current directory before giving up.
         local _had_explicit=false
         [[ ${#POSITIONAL_ARGS[@]} -gt 1 || ( ${#POSITIONAL_ARGS[@]} -eq 1 && "${POSITIONAL_ARGS[0]}" != "." ) ]] \
             && _had_explicit=true