Superctx:sync

SuperCtx Sync

Converge this repository into the correct SuperCtx state. /superctx:sync is the global setup, check, repair, and report command.

It checks the health of registered shims, initializes candidate repos, repairs missing or broken shims when safe, and reports healthy, repaired, unresolved, and warning states.

Before Running (Consent Boundary)

1. Direct User Invocation: If the user explicitly typed /superctx:sync or asked you to sync/repair/setup the repo, you have consent. Announce the action:

   Using SuperCtx to synchronize and verify project context.

2. Agent-Initiated Flow: If you detect a setup opportunity (no .ctx/ folder but candidate files exist) or shim issues during a task, you MUST obtain explicit natural-language user consent before running the command. Use this consent prompt for setup:

   Using SuperCtx, I can set up one shared context hub for this repo.

   This will:

   • create .ctx/SUPERCTX.md
   • back up the original instruction files under .ctx/sources/
   • replace the live instruction files with generated shims pointing to the hub

   Proceed?

Do not run /superctx:sync or make any mutations until you have explicit consent.

Run

PYTHONPATH="${CLAUDE_PLUGIN_ROOT}/scripts" python3 -m superctx sync

Then report to the user

Present the output from the command:

• On the healthy path (exit 0), confirm concisely that all shims are healthy:

  All SuperCtx context links are healthy.

• On initialization (exit 0), confirm the initialized files, hub location, and any backups.
• On repair (exit 0), list the repaired shims.
• On legacy or inspection warning/stops (exit 1), explain the warning and explain what needs to be inspected. Do not attempt automatic repair.