Development docsTracks main. Use your release’s bundled docs for its exact behavior; back up your store before upgrading.

Skip to content

Get started
Recipes
Reference
CLI
Ben Swanson

Sidebar Navigation

Introduction

Why bitshelf
Get started
Using with agents
Extending bitshelf
Install
Release matching
Compatibility
Platforms
Signing and provenance
Verification
Scale measurements

Recipes

Design docs ready for implementation
Focused handoffs between sessions
Keep code that didn’t ship
Archive without deleting
Let scratch material expire

Reference

Shelves, bits, and configuration
Saving and editing
Metadata mutations
Identifiers
Frontmatter values
Finding and reading
Timestamps
Timestamp fixtures
Moving bits
Deleting bits
Expiration and pruning
Shell completion
Safety and recovery
JSON contract

Command reference

bs
init
shelf
add
edit
move
aliases
list
search
show
open
context
validate
prune
completion

On this page

`bs shelf list`

Usage: bs shelf list

Flags

-h --help — Print help

Pager

NextWhy bitshelf

Development documentation (main). Use the docs bundled with your release for its exact contract.

© 2026 Ben Swanson