bundle

Explore and manage context bundles. Bundles are named, hierarchical groups of files, symbols, docs, and keywords that capture a concept or subsystem.

Usage

bobbin bundle <COMMAND> [OPTIONS]

Subcommands

list

Show all bundles in a tree view (L0 map).

bobbin bundle list
bobbin bundle list --json

Output shows bundle hierarchy with names, descriptions, and member counts:

Context Bundles (9 total):

  context — "Assembles relevant code for agent prompts" (1 files)
    ├── pipeline — "5-phase assembly: seed → coupling → bridge → filter → budget" (2 files)
    └── tags — "Tag-based scoring, pinning, and access control" (3 files)
  hook — "CLI injection into agent prompts" (1 files)
  search — "Hybrid semantic + keyword search" (1 files)
    └── lance — "LanceDB vector store backend" (1 files)

show

Display a bundle’s contents. L1 (outline) by default, L2 (full source) with --deep.

bobbin bundle show <NAME>           # L1: paths and symbol names
bobbin bundle show <NAME> --deep    # L2: full source code included
bobbin bundle show <NAME> --json    # JSON output

L1 output lists file paths, symbol references, docs, and keywords.

L2 output (--deep) reads and includes the full content of every ref and file — use this to bootstrap working context for a task.

create

Create a new bundle.

bobbin bundle create <NAME> [OPTIONS]
bobbin bundle create <NAME> --global    # Store in ~/.config/bobbin/tags.toml

Options:

Examples:

bobbin bundle create "search/reranking" --global \
  -d "Score normalization and result reranking" \
  -k "rerank,score,normalize" \
  -f "src/search/reranker.rs" \
  -r "src/search/reranker.rs::RerankerConfig"

bobbin bundle create "context/pipeline" --global \
  -d "5-phase assembly pipeline" \
  -f "src/search/context.rs,src/search/scorer.rs" \
  -i "tags"

add

Add members to an existing bundle.

bobbin bundle add <NAME> [OPTIONS]
bobbin bundle add <NAME> --global -f "src/new_file.rs"
bobbin bundle add <NAME> --global -r "src/file.rs::NewSymbol"
bobbin bundle add <NAME> --global -k "new keyword"
bobbin bundle add <NAME> --global --docs "docs/new-guide.md"

Supports the same -f, -r, -k, --docs flags as create.

remove

Remove members from a bundle, or delete the entire bundle.

bobbin bundle remove <NAME> --global -f "src/old_file.rs"
bobbin bundle remove <NAME> --global -r "src/file.rs::OldSymbol"
bobbin bundle remove <NAME> --global --all    # Delete entire bundle

suggest

Propose new bundles from coupling-graph analysis — clusters of files that change together but aren’t yet captured in any bundle.

bobbin bundle suggest                    # Default: coupling >= 0.3, cluster >= 3
bobbin bundle suggest --threshold 0.5    # Stricter coupling
bobbin bundle suggest --min-size 5       # Larger clusters only

additions

Suggest files to add to an existing bundle, ranked by how frequently they appear in the bundle’s beads’ changesets (GH#9 frequency analysis). A non-member file is suggested when it is touched by at least --min-fraction of the bundle’s beads.

bobbin bundle additions <NAME>

drift

Report bundle drift: files frequently touched alongside a bundle but missing from it, and dead members no longer present.

bobbin bundle drift            # All bundles
bobbin bundle drift <NAME>     # A single bundle

Global Options

Note: bundle operates entirely on the local tags.toml; the global --server and --role flags are ignored by bundle subcommands.

Storage

Bundles are defined as [[bundles]] entries in tags.toml:

• Per-repo: .bobbin/tags.toml
• Global: ~/.config/bobbin/tags.toml (use --global)

Global bundles are recommended for concepts that span multiple repos.

See Also

• Context Bundles Guide — workflow patterns, best practices
• Tags & Effects — bundles share the tags.toml config
• context — context assembly uses bundle data