# 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](/docs/build/reference/api) 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

| 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

| 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

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Build id |

## socra build list

List builds for a project

```text
socra build list [options]
```

### Options

| 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

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Build id |

## socra build cancel

Cancel a queued or running build

```text
socra build cancel <id>
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Build id |

## socra build artifact

Content-addressed OCI artifacts

| 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

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Artifact id |

## socra build artifact list

List artifacts for a project

```text
socra build artifact list [options]
```

### Options

| 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](/docs/build).

---

Company: Socra — Multiply Your Judgment
Canonical URL: https://cloud.socra.com/docs/build/reference/cli