v2.4 docs and v3 migration
v2.4 users can continue using the structured workflow. Starting with v3, the npm product focuses on the local Web Workspace. The Plugin, Legacy CLI, MCP, and Task Graph source remain available through separate entry points. Use the version-specific entry points below; do not replace old command versions with latest.
What changed
| Area | v2.4.0 | v3 Web-first |
|---|---|---|
| Product entry | Web and structured Plugin / CLI / MCP workflows documented together. | Web Workspace is the main product entry. |
| npm distribution | Complete standalone runtime, including structured commands. | Web/help/version only, with required terminal/runtime modules. |
| Structured workflow | Agent Bus, durable Tasks, review evidence, MCP, Task Graphs. | Retained in the independently versioned GitHub Plugin and source Legacy runtime; npm CLI pins 2.4.0. |
| Web cooperation | Lightweight Web terminal collaboration already existed. | Continues as the main experience; new features depend on the selected source/release. |
| Task data | Structured Task/Graph and Web task records are separate. | No automatic conversion of structured Tasks into Web tasks. |
This is a product and distribution change, not removal of the structured source. Plugin and npm Web version numbers are independent. Verified on 2026-10-21: npm latest and the source package are 3.0.2; the .codex-plugin Plugin is 2.4.0. This page does not declare an end-of-support date for v2.4 or promise future updates. v2.4 already had Web mode; v3 did not introduce Web from scratch.
Original v2.4.0 documentation
The local archive preserves the exact original files and is separate from the current translated guides:
The GitHub links below are pinned to the commit behind v2.4.0, rather than main. They preserve the original README, installation instructions, and documentation navigation. Relative repository links retain the snapshot; original external-site or main links may lead to current content. Use the pinned directory link below when you need the release text. These are historical materials: environment, version examples, and CLI behavior reflect the implementation at release time.
- v2.4.0 English README
- v2.4.0 Chinese README
- v2.4.0 documentation home
- v2.4.0 Chinese documentation entry
- v2.4.0 getting started
- v2.4.0 AI installation guide
- v2.4.0 Web Workspace and Inspector guide
- Browse all v2.4.0 docs
Snapshot: v2.4.0 → 3e36942ce52004ad3136c6f24be57a8255361c75.
Retained structured reference
These pages follow the retained Plugin / source Legacy implementation and may receive corrections after v2.4.0. They are not frozen v2.4.0 snapshots. The “v2.4 lineage” notice identifies the structured workflow, not a release-date freeze. For exact release behavior use the original-document links above.
- Structured onboarding
- Legacy Skill install, update, uninstall (English)
- Plugin E2E (English), MCP (English), MCP troubleshooting (English)
- Protocol (English), Task Graph (English)
- Session Runtime (English), Event Journal (English)
- Adapter author guide (English), Adapter conformance (English)
Continue with v2.4 or move to Web
For the published structured CLI, keep the version explicit:
npx @hogancv/coordinate-agents@2.4.0 --help
npx @hogancv/coordinate-agents@2.4.0 doctorThe GitHub Plugin uses its own bundled runtime. From a current source checkout, use node bin/coordinate-agents-legacy.mjs for structured commands. Current source may include fixes beyond the historical release.
To use Web, follow Getting started and Workspace guide. Existing structured records do not become Web tasks; preserve them if you still need the old workflow. Installing the Web package is not a request to delete or rewrite existing .agent-bus/ data. Migration does not require deleting old tasks. Web tasks and structured Task/Graph records have separate storage; preserve the old data and create Web tasks through the current entry point. Web receipts do not constitute structured Task review or release approval.
For release details, see v3 distribution evidence (English) and Changelog.