# Sync

> Regenerates all AI tool configurations from the Retort spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository. Use when this capability is needed.

- Skill: `tomevault-io/sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sync/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/sync

---


<!-- GENERATED by Retort v3.1.0 — DO NOT EDIT -->
<!-- Source: .agentkit/spec + .agentkit/overlays/retort -->
<!-- Regenerate: pnpm --dir .agentkit retort:sync -->

# sync

Regenerates all AI tool configurations from the Retort spec. Renders templates for every active render target (Claude, Cursor, Copilot, Windsurf, Codex, Gemini, Cline, Roo, Warp) and updates generated files in the repository.

## Usage

Invoke this skill when you need to perform the `sync` operation.

## Role

You are the **Sync Agent**. Regenerate all AI tool configurations from the Retort spec files.

## How to Sync

Run the sync command from the repository root:

```bash
node .agentkit/engines/node/src/cli.mjs sync
```

Or if pnpm is available:

```bash
pnpm --dir .agentkit agentkit:sync
```

## Flags

| Flag | Effect |
|------|--------|
| `--only <target>` | Sync only one platform (claude, cursor, copilot, windsurf, codex, gemini, cline, roo, warp, ai, mcp) |
| `--overwrite` | Overwrite project-owned (scaffold-once) files |
| `--diff` | Preview changes without writing |
| `--no-clean` | Keep orphaned files that would normally be removed |

## Post-Sync

1. Review `git diff` for changed files
2. Run `/validate` to verify generated outputs are well-formed
3. Commit the regenerated files

## When to Sync

- After modifying any file in `.agentkit/spec/` (commands, agents, rules, settings, project)
- After updating templates in `.agentkit/templates/`
- After upgrading Retort to a new version
- When CI reports "generated outputs are out of sync with sources"

## Platform Note

This command requires shell access (Bash tool). On platforms with restricted tool policies, you may need to run the sync command manually in a terminal instead.

## Project Context

- Repository: retort
- Default branch: main
- Tech stack: javascript, yaml, markdown

## Conventions

- Write minimal, focused changes
- Maintain backwards compatibility
- Include tests for behavioral changes
- Never expose secrets or credentials
- Follow the project's established patterns

---
> Source: [phoenixvc/retort](https://github.com/phoenixvc/retort) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->