agentbundler

package module

v0.1.2 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

Coding-agent assets are not portable. The same skill gets copied into several vendor-specific directory trees, then those generated copies drift from their source.

Agentbundler compiles one explicit source into deterministic native layouts for Claude Code, Codex, Pi, GitHub Copilot, Grok Build, and Cursor. It applies target-specific composition rules, renders the selected layouts, records input/output hashes, and can prove whether generated output is current.

source + agentbundle.json
        │
        ▼
 import → compose → render → build or check
        │
        └───────────────► native target trees + provenance

build stages, verifies, and replaces the generated output tree.
check compiles in memory and reports missing, changed, or extra output without writing.
Unsupported capabilities fail explicitly instead of being silently dropped.

The current lossless target subset supports skills and one source package per target. Agents, hooks, native resources, and multi-package aggregation are rejected by the target renderers.

Install

brew install alexei-led/tap/agentbundler

Go alternative

Requires Go 1.26.

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

Start

agentbundler build --root /path/to/project
agentbundler check --root /path/to/project

See the guide for source layout, configuration, target output, examples, and architecture.

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.