Build CLI reference
Source: @socra/build-cli@0.2.2.
This reference includes every command, argument, and option declared by this released package. Defaults and accepted values are included where the package declares them. Command-specific validation and permissions also apply; see the API reference for resource contracts.
Use socra build --help, or append --help to any command, to inspect the locally installed version.
socra build
Build source into immutable OCI artifacts
Scroll to see all columns.
| Command | Purpose |
|---|---|
socra build create | Snapshot the current directory and wait for its OCI artifact |
socra build get | Show a build |
socra build list | List builds for a project |
socra build logs | Print build logs |
socra build cancel | Cancel a queued or running build |
socra build artifact | Content-addressed OCI artifacts |
socra build create
Snapshot the current directory and wait for its OCI artifact
Text
socra build create [options]
Options
Scroll to see all columns.
| Option | Input | Description |
|---|---|---|
--project | Value | Socra project id (or SOCRA_PROJECT) |
--profile | Value | bun-web, bun-service, or docker |
--root | Value | Package root within the repository |
--name | Value | Artifact/workload name |
--async | Presence flag | Return immediately after queuing |
socra build get
Show a build
Text
socra build get <id>
Arguments
Scroll to see all columns.
| Argument | Required | Description |
|---|---|---|
id | Yes | Build id |
socra build list
List builds for a project
Text
socra build list [options]
Options
Scroll to see all columns.
| Option | Input | Description |
|---|---|---|
--project | Value | Socra project id |
--status | Value | Build status |
--limit | Value | Page size |
--after | Value | Page cursor |
socra build logs
Print build logs
Text
socra build logs <id>
Arguments
Scroll to see all columns.
| Argument | Required | Description |
|---|---|---|
id | Yes | Build id |
socra build cancel
Cancel a queued or running build
Text
socra build cancel <id>
Arguments
Scroll to see all columns.
| Argument | Required | Description |
|---|---|---|
id | Yes | Build id |
socra build artifact
Content-addressed OCI artifacts
Scroll to see all columns.
| Command | Purpose |
|---|---|
socra build artifact get | Show an artifact |
socra build artifact list | List artifacts for a project |
socra build artifact get
Show an artifact
Text
socra build artifact get <id>
Arguments
Scroll to see all columns.
| Argument | Required | Description |
|---|---|---|
id | Yes | Artifact id |
socra build artifact list
List artifacts for a project
Text
socra build artifact list [options]
Options
Scroll to see all columns.
| Option | Input | Description |
|---|---|---|
--project | Value | Socra project id |
--build | Value | Filter by build id |
--limit | Value | Page size |
--after | Value | Page cursor |
Next step
Return to the Build overview.