Agent Bundle

agent-bundle

`agent-bundle` compiles one Agent Bundle project into portable, Codex, and Claude Code artifacts. It discovers skills, validates a typed configuration, bundles local JavaScript/TypeScript entry points, and writes the host-specific metadata needed by each selected target.

It requires Node.js 22.19 or later.

Quick start

Install the package in the project that owns the plugin, describe the plugin once, and compile it for every host you target:

npm install --save-dev agent-bundle

// agent-bundle.config.ts
import { defineConfig } from 'agent-bundle/config';

export default defineConfig({
  plugin: { name: 'my-plugin', version: '0.1.0', description: 'One bundle, every agent host.' },
  targets: ['plugin'],
  skills: ['skills/*'],
  hooks: { sessionStart: { handler: './src/session-start.ts' } },
  mcp: { servers: { tools: { entry: './src/mcp.ts' } } },
});

agent-bundle dev --root .              # local workbench with live rebuilds
agent-bundle build --root . --output dist

`targets: ['plugin']` emits one **agent plugin bundle** at `dist/plugin/` that installs into multiple hosts from the same root: `.claude-plugin/` (Claude Code), `.codex-plugin/` (Codex), and `.cursor-plugin/` (Cursor) manifests over shared `skills/`, `hooks/`, `mcp/`, `scripts/`, and `assets/` directories, plus a generated `AGENTS.md` install matrix. Hooks compile once into host-detecting wrappers that serve Claude Code and Codex; Cursor consumes the skills and MCP servers. Per-host artifacts remain available as `claude`, `codex`, and `portable` targets when a host-specific layout is required.

Install and build

agent-bundle dev --root .
agent-bundle build --root . --output artifact

The implemented commands are:

• agent-bundle build validates source and writes an artifact.
• agent-bundle inspect displays the normalized source configuration and target plans.
• agent-bundle validate validates source; `agent-bundle validate --artif