BlueForge Docs

forge storage

Manage storage buckets and objects.

Command

forge storage <subcommand> [args]

Arguments

None. Use a

<subcommand>
— run
forge --help
for per-subcommand arguments.

Flags

None.

Subcommands

SubcommandUsage
list-buckets
forge storage list-buckets
create-bucket
forge storage create-bucket <name>
get-usage
forge storage get-usage
search
forge storage search <query>

Examples

List buckets:

forge storage list-buckets
# → bucket-1    32 objects    1.2 GB
# → bucket-2    128 objects   4.5 GB

Create a bucket:

forge storage create-bucket my-assets

Get usage:

forge storage get-usage
# → Total objects: 160
# → Total size: 5.7 GB
# → Buckets: 2

Search objects:

forge storage search "invoice 2026"

Errors

Exit codeMeaning
0Success
1Failed

Pitfalls

  • Bucket naming — bucket names must be globally unique within the project. Use lowercase alphanumeric and hyphens.

See also

{auto-injected}

Tested against

{auto-injected}