v6.3.0

Release 6.3.0 — 2026-11-05

Summary

ycc 6.3.0 makes install.sh native-only. install and sync now install Claude, Codex and Cursor through their plugin CLIs (ycc-mcp@ycc and ycc-hooks@ycc included), and they clean up files left by older installs, but only files ycc can prove it wrote. The legacy file-copy and config-merge routes and the migrate subcommand are gone.

Added

977fbb6 feat(install)!: install natively only; drop legacy install routes (YAN-1962) (#534)

• Claude: --intent mcp installs ycc-mcp@ycc and --intent hooks installs ycc-hooks@ycc, at project scope by default and user scope with --global. This fixes refusing to replace directory with symlink: ~/.claude/hooks.
• Codex: base installs ycc@ycc and ycc-mcp@ycc with codex plugin add, and --intent mcp installs ycc-mcp@ycc.
• Cursor: install registers the GitHub marketplace with agent plugin marketplace add and lists which packages to select in /plugins.
• OMP: old omp plugin link and marketplace installs are cleaned up during install.

Changed

• The legacy cleanup (formerly migrate --apply) runs as part of install, sync and remove --intent base. It removes only files identical to what ycc wrote, links ycc owns, and config entries ycc recorded. Edited copies and your own files are kept and reported. If the cleanup fails, it prints a warning and the install continues.

Removed

977fbb6 feat(install)!: install natively only; drop legacy install routes (YAN-1962) (#534)

• The migrate subcommand (--apply, --marketplace-source) and the deprecation hints.
• Claude: the ~/.claude/hooks symlink, the settings hooks merge, the MCP merge into ~/.claude.json / .mcp.json, and standalone skill, agent and command copies.
• Codex: the local-ycc-plugins catalog, plugin symlinks, cache copies for Codex builds older than 0.160, the [mcp_servers] merge and standalone skill copies.
• Cursor: every file copy (skills, agents, commands, rules bundle, the hooks carrier, the MCP merge).
• --skills, --agents, --commands, --mcps, --with-deps, --skills-home and --hooks <events> for claude, codex, cursor and omp. They still apply to opencode and agents.

Fixed

• remove --target cursor --intent <content> no longer drops the whole ycc marketplace; only --intent base does.

Packages

Package	Runtime	Status	Mechanism	Listed	Version or target	Notes
@yandy-r/ycc-opencode	opencode	included	npm	no	6.3.0	experimental; opt-in; not yet published; Experimental and opt-in in v6; the @yandy-r npm scope is already owned. The V2 setup hook registers components and delivers instructions through the context hook; install.sh file copy stays the primary opencode path.
ycc	claude	included	native	yes	6.3.0	Shipping entry; stays visible in every catalog throughout the v6 flip. status-bar@ycc-mods is versioned independently and stays outside this manifest.
ycc	codex	included	native	yes	6.3.0	Listed in the ycc Codex catalog (.agents/plugins/marketplace.json) with a local source at ./.codex-plugin/ycc; installs together with ycc-mcp. Replaces the legacy local-ycc-plugins catalog.
ycc	cursor	included	native	yes	6.3.0	Ships through the GitHub marketplace; no cursor.com submission before post-6.0.
ycc	omp	included	native	yes	6.3.0	Generated OMP package under packages/omp/ycc (omp >=18.12.2) with .omp-plugin and .claude-plugin manifests and package.json, rewritten ${CLAUDE_PLUGIN_ROOT}, /ycc: and _shared references, agents translated to @ROLE models, and one commands/.md entrypoint per public skill (/ycc:). Listed in the root .omp-plugin/marketplace.json (YAN-1180). install.sh --target omp exports it to a local marketplace (--mode local) or registers the repository catalog (--mode repo) and installs it through omp plugin (user or project scope).
ycc	pi	deferred	native	no	target v6.3.0	Deferred: generated Pi package under packages/pi/ycc (pi >=1.2.0, recommended 1.5.0) with skills, _shared, ycc: command and subagent extensions, and agent data; rewrites ${CLAUDE_PLUGIN_ROOT}, /ycc: and $ARGUMENTS, which Pi leaves literal. Pi has no catalog: install.sh --target pi will run pi install . No generator or installer ships yet.
ycc-agents	claude	deferred	native	no	target v7.0.0	Deferred to v7.0.0 as a breaking change with qualified ycc-agents: references; the v6 namespace spike rejects a shared manifest name. Hidden prep: claude_agents_split.py builds and validates the split on demand (claude-native check); test-claude-agents-split.sh is the opt-in live dispatch proof.
ycc-all	claude	included	native	yes	6.3.0	Meta plugin that installs ycc, ycc-mcp, and ycc-hooks through Claude plugin dependencies.
ycc-all	omp	excluded	native	no	target v6.1.0	Excluded: the OMP marketplace does not read plugin dependencies, so ycc-all (on Claude the union of ycc, ycc-mcp, and ycc-hooks) is omitted from the OMP catalog; install ycc and ycc-mcp separately; herdr reporting comes from herdr integration install omp.
ycc-all	pi	excluded	native	no	target v6.3.0	Excluded: Pi packages cannot depend on Pi packages, so ycc-all (on Claude the union of ycc, ycc-mcp, and ycc-hooks) has no Pi package; install ycc and ycc-mcp separately; ycc-hooks is excluded on Pi and herdr reporting comes from herdr integration install pi.
ycc-hooks	claude	included	native	yes	6.3.0	Native plugin hooks/hooks.json needs Claude Code 2.1.300 or later. install.sh installs it (project scope by default, user scope with --global); once ycc-hooks@ycc is explicitly enabled in ~/.claude/settings.json, the automatic legacy cleanup prunes the installer-owned settings hooks an older installer wrote.
ycc-hooks	codex	excluded	native	no	target v6.0.0	Excluded: NO-GO until verified under YAN-1149 (YAN-1149 gate). Hooks stay out of the Codex bundle.
ycc-hooks	cursor	included	native	yes	6.3.0	sessionStart only; WorktreeCreate is not implemented for Cursor.
ycc-hooks	omp	excluded	native	no	target v6.1.0	Excluded: herdr ships its own OMP integration (herdr integration install omp), which reports the session and agent state; a ycc reporter is ignored by herdr (non-herdr source) or corrupts herdr's ordering (herdr:omp). WorktreeCreate has no OMP event. ycc ships no OMP hooks (YAN-1174); its only OMP extension is the agent scope guard inside the ycc package (YAN-1250).
ycc-hooks	pi	excluded	native	no	target v6.3.0	Excluded: Pi never runs shell hooks or hooks.json, and WorktreeCreate has no Pi event. herdr reporting is herdr's own integration (herdr integration install pi), and ycc ships no Pi hook extension (ADR 0003).
ycc-mcp	claude	included	native	yes	6.3.0	Native MCP-only plugin.
ycc-mcp	codex	included	native	yes	6.3.0	Native MCP-only plugin; carries the MCP servers the Codex ycc plugin used to ship. Listed together with ycc.
ycc-mcp	cursor	included	native	yes	6.3.0	Native MCP-only plugin.
ycc-mcp	omp	included	native	yes	6.3.0	Generated OMP package under packages/omp/ycc-mcp (omp >=18.12.2) with .omp-plugin and .claude-plugin manifests, package.json, and a root .mcp.json byte-identical to mcp-configs/mcp.json (secret-literal audited; ${VAR} env placeholders stay unexpanded until omp starts a server). Servers load as ycc-mcp:. Listed in the root .omp-plugin/marketplace.json (YAN-1180). install.sh --target omp installs it next to ycc through omp plugin (user or project scope); a running session picks it up after /reload-plugins or a restart.
ycc-mcp	pi	deferred	native	no	target v6.3.0	Deferred: extension package (pi >=1.2.0) whose registrar calls pi.registerMcpServer for the shipped server set read as package data, because Pi never reads mcp.json from a package; a same-name user mcp.json entry wins, tools become mcp____, and SSE servers are rejected. An opt-in install.sh --mcp merge into /mcp.json is the fallback for pi mcp shell commands.
ycc-rules	cursor	included	native	yes	6.3.0	Cursor-only rules package. No Claude ycc-rules: Claude rules stay on install.sh (see installer-fallback claude).
ycc-rules	omp	included	native	yes	6.3.0	Generated package under packages/omp/ycc-rules (omp >=18.12.2): 31 flat rules named ycc--, paths→globs, description kept, alwaysApply only when true. Language rules are rulebook entries read via rule://; 5 description-less ycc--trigger TTSR rules (glob-gated edit/write, interruptMode never) attach them once per session and once per subagent that edits a matching file. Listed in the root .omp-plugin/marketplace.json (YAN-1180).
ycc-rules	pi	deferred	native	no	target v6.3.0	Deferred: extension package (pi >=1.2.0) carrying the rule files and a path-rule injector that attaches a family's rules after a matching read, edit, or write. Always rules use the installer-fallback AGENTS.md link.

File-copy packages (the installer fallback) have no native manifest and are not versioned here.

Validation

• ./scripts/sync.sh — OK
• ./scripts/validate.sh — OK
• python3 -m json.tool .claude-plugin/marketplace.json — OK
• python3 -m json.tool ycc/.claude-plugin/plugin.json — OK

Upgrade Notes

Breaking for installer users. Run your usual install/sync command again. It installs the native packages and removes legacy copies that ycc can prove it wrote.

• ycc migrate now exits with a notice. Use install/sync instead.
• Claude hooks and MCP: ycc sync --target claude --intent hooks,mcp --global for user scope, or drop --global for the current project. Claude hooks need Claude Code 2.1.300 or later.
• Codex now needs the Codex CLI 0.160 or later (codex plugin). Custom agents in ~/.codex/agents, settings and rules still come from the installer.
• Cursor has no non-interactive plugin install. After ycc install --target cursor, select the packages it names in /plugins (agent CLI or IDE).
• Scripts that pass --skills, --agents, --commands, --mcps or --hooks <events> for claude, codex or cursor must drop those flags. With --target all the flags still apply to opencode and agents and are skipped elsewhere with a notice.

Commit Log

977fbb6 feat(install)!: install natively only; drop legacy install routes (YAN-1962) (#534)

---

Previous release: v6.2.1