crab repo
Manage logical repositories on a Crab managed service. Repository arguments
use ORGANIZATION/REPOSITORY, not a bucket or physical prefix.
Synopsis
crab repo [OPTIONS] <COMMAND>Common options
| Option | Default | Description |
|---|---|---|
--service <AUTHORITY> | Active profile | Target an exact installed managed-service authority |
--json | false | Emit one structured JSON envelope |
Commands
create
crab repo create [OPTIONS] <REPOSITORY>crab repo create acme/modelsThe service owns placement and begins repository provisioning. Inspect the repository until it is active before clone or push.
list
crab repo list [OPTIONS] <ORGANIZATION>| Option | Default | Description |
|---|---|---|
--cursor <CURSOR> | None | Opaque cursor returned by the preceding page |
--limit <LIMIT> | 50 | Page size from 1 through 100 |
crab repo list acme --limit 25 --jsoninfo
crab repo info [OPTIONS] <REPOSITORY>crab repo info acme/models --jsonThe response contains logical IDs, canonical URL, lifecycle state, transfer capabilities, and revision. It contains no permanent storage credential.
rename
crab repo rename [OPTIONS] --revision <REVISION> <REPOSITORY> <NEW_SLUG>crab repo rename acme/models foundation-models --revision 3Rename preserves the immutable repository ID and physical placement.
archive
crab repo archive [OPTIONS] --revision <REVISION> <REPOSITORY>crab repo archive acme/models --revision 3Archived repositories reject managed writes.
delete
crab repo delete [OPTIONS] --revision <REVISION> <REPOSITORY>deleted=$(crab repo delete acme/models --revision 4 --json)
deleted_revision=$(printf '%s\n' "$deleted" | jq -er '.data.revision')Deletion first enters the managed retention lifecycle. The client cannot request bucket-wide or arbitrary-prefix deletion.
restore
crab repo restore [OPTIONS] --revision <REVISION> <REPOSITORY>crab repo restore acme/models --revision "$deleted_revision"Restore is available only while retained data and metadata still satisfy the service lifecycle policy.
Revision safety
All lifecycle mutations require the current revision:
revision=$(crab repo info acme/models --json | jq -er '.data.revision')
crab repo archive acme/models --revision "$revision"