battery-pack

Curated crate bundles with docs, templates, and agentic skills.

📖 Read the book

What's a Battery Pack?

A battery pack bundles everything you need to get started in an area: curated crates, documentation, examples, and templates.

Think of it like an addition to the standard library targeting a particular use case, like building a CLI tool or web server.

Installing the CLI

Install cargo-bp:

cargo install cargo-bp
# or
cargo binstall cargo-bp

Shell Completions

To enable tab autocompletion, add the following line to your shell configuration (~/.bashrc, ~/.zshrc, etc.):

source <(cargo bp completions bash)

(Replace bash with zsh, fish, or your specific shell).

Using the CLI

# Create a new project from a battery pack template
cargo bp new cli

# Add a battery pack to an existing project
cargo bp add cli

# Show info about a battery pack
cargo bp show cli

Authoring Battery Packs

The battery-pack crate is also a battery pack itself.

# Create a new project from a battery pack template
cargo bp new battery-pack