agentbundler

package module

v0.1.3 Latest Latest Go to latest Published: Jul 13, 2026 License: MIT Imports: 0 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/alexei-led/agentbundler

Links

Open Source Insights

README ¶

Agentbundler

One source → target-specific coding-agent layouts

Claude Code · Codex · Pi · Copilot · Grok Build · Cursor

Define coding-agent assets once. Build the target-specific trees each agent expects.

Why this exists

SKILL.md is useful common ground, but it does not define a shared metadata format, plugin/package layout, or a common way to ship agents, hooks, and scripts. Each coding agent adds its own conventions. The same instructions also do not work equally well across models: wording that helps an OpenAI model may need a different version for an Anthropic model, and vice versa.

Maintaining copied skills and plugin files for every target is tedious. Copies drift. Small target or model differences become manual release work.

Agentbundler keeps one source of truth, then lets you customize the parts that actually need to differ: frontmatter, Markdown sections, support files, and short target-wide preambles. It renders the result into the directory layout expected by Claude Code, Codex, Pi, GitHub Copilot, Grok Build, and Cursor.

canonical source + manifest
          │
          ▼
   import → customize → render
          │
          ├── Claude Code   .claude/skills/…
          ├── Codex         .codex-plugin/ + skills/…
          ├── Pi            .pi/skills/…
          ├── Copilot      .github/skills/…
          ├── Grok Build   .grok/skills/…
          └── Cursor       .cursor-plugin/ + skills/…

Current scope

Today the target renderers produce one package of skills and their support files. The source model can recognize richer assets and native gaps, but agents, hooks, scripts, native resources, and multi-package aggregation are not rendered by the current adapters. Unsupported capabilities fail instead of being silently discarded.

Agentbundler is a compiler, not an agent runtime, installer, marketplace, or publisher. It creates target-ready files; your project or release workflow decides where to install or publish them.

Install

Homebrew is the default install:

brew install alexei-led/tap/agentbundler

Or install with Go 1.26+:

go install github.com/alexei-led/agentbundler/cmd/agentbundler@latest

Start with an existing bundle

From a directory containing agentbundle.json:

agentbundler build
agentbundler check

build replaces the configured output directory. Use a dedicated generated directory, not a working project root. For a complete first bundle, see the quick start.

What can be customized

A target overlay can:

merge or remove JSON frontmatter keys, including target-defined metadata such as tools;
replace the whole Markdown body;
replace the body under an exact heading path;
add, replace, or delete support files;
prepend a short target-wide policy through composition.

See customization for the exact sidecar format and examples.

Documentation

License

MIT

Documentation ¶

Overview ¶

Package agentbundler is the target-neutral Agentbundler compiler product.

The executable entry point is cmd/agentbundler. Internal packages own source import, composition, target rendering, and generated-output effects.

Source Files ¶

View all Source files

doc.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
agentbundler command
internal
artifact Package artifact validates and applies complete generated-output plans.	Package artifact validates and applies complete generated-output plans.
artifact/compare Package compare detects exact drift between a build plan and generated output.	Package compare detects exact drift between a build plan and generated output.
artifact/nativeverify Package nativeverify runs declared native verification commands.	Package nativeverify runs declared native verification commands.
artifact/provenance Package provenance adds deterministic build evidence to compiler plans.	Package provenance adds deterministic build evidence to compiler plans.
artifact/write Package write materializes validated build plans as complete output trees.	Package write materializes validated build plans as complete output trees.
compiler Package compiler coordinates source import, composition, target rendering, and artifacts.	Package compiler coordinates source import, composition, target rendering, and artifacts.
compiler/composition Package composition resolves source inventories for one target.	Package composition resolves source inventories for one target.
compiler/model Package model defines the target-neutral data exchanged by compiler subsystems.	Package model defines the target-neutral data exchanged by compiler subsystems.
compiler/source Package source routes explicit source manifests to their topology importers.	Package source routes explicit source manifests to their topology importers.
compiler/source/bundle Package bundle imports Agentbundler's canonical bundle source layout.	Package bundle imports Agentbundler's canonical bundle source layout.
compiler/source/claudeplugin
compiler/source/skillrepo Package skillrepo imports explicit roots from a generic skills repository.	Package skillrepo imports explicit roots from a generic skills repository.
target Package target resolves and dispatches built-in target adapters.	Package target resolves and dispatches built-in target adapters.
target/claude Package claude renders normalized packages for Claude Code.	Package claude renders normalized packages for Claude Code.
target/codex Package codex renders normalized packages as Codex plugins.	Package codex renders normalized packages as Codex plugins.
target/copilot Package copilot renders normalized packages for GitHub Copilot.	Package copilot renders normalized packages for GitHub Copilot.
target/cursor Package cursor renders normalized packages as Cursor plugins.	Package cursor renders normalized packages as Cursor plugins.
target/grok Package grok renders normalized packages for Grok Build.	Package grok renders normalized packages for Grok Build.
target/pi Package pi renders normalized packages for Pi.	Package pi renders normalized packages for Pi.
target/plugin Package plugin renders the common single-package native plugin skill subset.	Package plugin renders the common single-package native plugin skill subset.
target/skills Package skills renders the common native skill subset for target adapters.	Package skills renders the common native skill subset for target adapters.