bun-workspaces has been deprecated and is now developed as pacwich, which supports Bun, npm, and pnpm workspaces, with a mostly backwards compatible CLI and API. Users can expect little to no disruption beyond the package name change and config file name changes.
A full migration guide covering all differences between the packages is available at https://pacwich.dev/intro/bun-workspaces-migration
Installation docs are available at https://pacwich.dev/intro/getting-started
You can also instruct an LLM agent to read https://pacwich.dev/intro/bun-workspaces-migration/index.md to assist with migration.
Read the launch blog post about the motivations and development strategy.
bun-workspaces will not receive further releases save for critical security patches, if necessary. This website will stay up at least through 2026. Once decommissioned, documentation will be consolidated to the package README.
AI Integrations: AGENTS.md
bun-workspaces provides an AGENTS.md file that can be used to provide context to AI tools about the package, which
can be found at node_modules/bun-workspaces/AGENTS.md after you install bun-workspaces.
The content of this file is the same as the combined contents of the MCP server's documentation resources.
You can use this file to provide immediate knowledge of bun-workspaces to an agent.
CLAUDE.md
Since CLAUDE.md supports importing other files, you can easily integrate this file into your context by adding the following line to your CLAUDE.md file:
<!-- CLAUDE.md contents -->
@./node_modules/bun-workspaces/AGENTS.mdOther Tooling
If your tool does not support imports like CLAUDE.md, you can manually copy the contents of node_modules/bun-workspaces/AGENTS.md into your tool's context
or create a symlink to the file in your tool's config.
You might also simply instruct your agent to read node_modules/bun-workspaces/AGENTS.md via a prompt.