# Metagit Workspace Sync

> Sync workspace repositories safely using metagit with scoped fetch, pull, or clone actions. Use when repository content must be refreshed for implementation.

- Skill: `metagit-ai/metagit-workspace-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add metagit-ai/metagit-workspace-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/metagit-ai/metagit-workspace-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: metagit-ai (https://skillmd.com/u/metagit-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/metagit-ai/metagit-workspace-sync

---


# Syncing Workspace Repositories

Use this skill when repository state must be updated.

## Workflow

1. Confirm active workspace and target project.
2. Start with read-only status and fetch where possible.
3. Use pull/clone only when required for the current objective.
4. Summarize which repositories changed and what remains stale.

## Commands

- `metagit project sync --project <name>`
- MCP `metagit_workspace_sync` for batch fetch/pull/clone (`repos`, `only_if`, `dry_run`, `max_parallel`)
- MCP `metagit_repo_sync` for a single repository (requires `allow_mutation` for pull/clone)
- `./skills/metagit-control-center/scripts/control-cycle.sh [root_path] ["query"] [preset]`

## Output Contract

Return:
- repositories synced
- sync mode used (fetch/pull/clone)
- failures and retry guidance

## Safety

- Limit sync to repos defined in `.metagit.yml`.
- Avoid broad synchronization if only a subset is needed.