skills.rest
manifoldlogic
manifoldlogicOFFICIAL
Explore all skills by this author →
GitHub

workspace-sync

Reconcile the VS Code workspace file with repositories on disk.

Updated Nov 9, 2025
Search Tags:#git#worktree#workspace#VS Code#repo sync
One-click install
npx skills add https://github.com/manifoldlogic/claude-code-plugins --skill workspace-sync-manifoldlogic
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workspace-sync
Source: https://github.com/manifoldlogic/claude-code-plugins/tree/main/plugins/devx/skills/workspace-sync
Command: npx skills add https://github.com/manifoldlogic/claude-code-plugins --skill workspace-sync-manifoldlogic

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, realpath, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of maintaining consistency between the VS Code workspace file and the actual repositories on disk. It helps manage and organize the workspace by enforcing naming conventions, ordering, and completeness.

Core Features & Use Cases

  • Reconciliation: Synchronize the workspace.code-workspace file with the actual repositories.
  • Naming Conventions: Apply specific naming conventions to repositories (<repo> | main, <repo> ⛙ <WORKTREE>).
  • Ordering: Ensure that entries are in the correct order (devcontainer first, then alphabetical).
  • Maintenance: Remove stale entries and add missing ones to keep the workspace up-to-date.

Quick Start

Run the 'sync-workspace.sh' script to update your workspace file based on the repositories on disk.

Frequently Asked Questions about workspace-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync my VS Code workspace file with repositories on disk?▼

You can sync your VS Code workspace by running the sync-workspace.sh script, which reconciles the workspace.code-workspace file with disk repositories, applying naming conventions, ordering, and completeness checks to keep entries up-to-date.

Why does my VS Code workspace have stale or missing git repositories?▼

Stale or missing git repositories in your VS Code workspace occur when the workspace file drifts from disk. A workspace sync reconciles the file, removing stale entries and adding missing repositories to maintain completeness.

Do I need jq and realpath to reconcile my VS Code workspace?▼

Yes, you need jq and realpath installed to reconcile your VS Code workspace. The sync script requires jq to parse workspace JSON and realpath to resolve absolute repository paths on disk.

Can I apply naming conventions to git worktrees in a VS Code workspace?▼

Yes, you can apply naming conventions to git worktrees in a VS Code workspace. The sync process formats repository entries using conventions like <repo> | main and <repo> ⛙ <WORKTREE> for clear identification.

What is the correct ordering for repository entries in a VS Code workspace file?▼

The correct ordering for repository entries in a VS Code workspace file places devcontainer entries first, followed by remaining repositories in alphabetical order to ensure a predictable development environment.

Does VS Code workspace sync work with multiple repository types and devcontainers?▼

Yes, VS Code workspace sync works with multiple repository types and devcontainers. The reconciliation script handles various repository structures, ordering devcontainers first and synchronizing all valid entries with disk.

Related Skills

Explore More Software Engineering Skills→
ZaxbyHubZaxbyHub
437

add-path-type-assertions-or-realpath-resolve-calls-in-path-joini

Add path-type assertions or realpath/resolve calls before Node.js path-joining operations.

Official
Intermediate
manifoldlogicmanifoldlogic

worktree-merge

Merge a git worktree to the main branch and remove its VS Code workspace folder.

Official
Advanced
joonlabjoonlab
8

git-worktree

Create, list, and remove Git worktrees for parallel development environments.

Community
Advanced
GenerativeAgentsGenerativeAgents

glossary-creation

Extract and consolidate project terms into a standardized glossary at docs/glossary.md.

Official
Advanced