Config Manager Reference

Config Manager Reference

Use this skill when the user asks for an AI Config Sync Manager reference, cheatsheet, or a full listing of CLI commands, areas, risk levels, mapping qualities, sync action verbs, terminology layers, hidden markers, or known file locations.

Behavior

• If the user passes -h / --help (or asks for usage/help), run ... reference --help and print the CLI output as-is — do not emit the reference markdown.
• Resolve the bundled CLI from the Codex plugin root: AI_CONFIG_SYNC_HOST=codex "$HOME/.agents/plugins/ai-config-sync-manager/bin/ai-config-sync" reference. The launcher resolves the runtime via AI_CONFIG_SYNC_ROOT (dev override) → PATH ai-config-sync → npm exec fallback.
• Always export AI_CONFIG_SYNC_HOST=codex before invoking the CLI from this skill so the default sync direction is codex -> claude.
• Default mode prints the markdown reference to stdout. Print the CLI output as-is — do not rewrite, summarize, or regroup the sections.
• When the user asks for a saved snapshot, pass --output <path>: AI_CONFIG_SYNC_HOST=codex "$HOME/.agents/plugins/ai-config-sync-manager/bin/ai-config-sync" reference --output <path> writes the markdown to the given path and prints the resolved absolute path on success.
• The repository also commits a static snapshot at docs/reference.md for offline / GitHub browsing. Mention that path when the user asks where to read the reference without running the CLI.
• Reference is read-only; it does not modify any host configuration.
• If the bundled CLI is unavailable, report that the user must npm install -g ai-config-sync-manager (or run npm link from the repo) and re-run connect.

Safety

• Reference is read-only. Do not chain it with sync, connect, or any write operations from this skill.
• Do not regenerate docs/reference.md automatically; only run with --output when the user explicitly asks for a written copy.