# Projects CLI reference

Source: `@socra/project-cli@0.0.7`.

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/project/reference/api) for resource contracts.

Use `socra project --help`, or append `--help` to any command, to inspect the locally installed version.

## socra project

Manage Socra projects in the active account

| Command | Purpose |
| --- | --- |
| `socra project create` | Create a project |
| `socra project get` | Show a single project by id |
| `socra project list` | List a page of projects (cursor printed when more remain) |
| `socra project update` | Update a project |
| `socra project delete` | Delete a project by id |

## socra project create

Create a project

```text
socra project create <slug>
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `slug` | Yes | Project slug |

## socra project get

Show a single project by id

```text
socra project get <id>
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Project id, e.g. proj_… |

## socra project list

List a page of projects (cursor printed when more remain)

```text
socra project list [options]
```

### Options

| Option | Input | Description |
| --- | --- | --- |
| `--limit` | Value | Max rows to return in this page (default 20) |
| `--after` | Value | Cursor from a previous page — return rows after it |

## socra project update

Update a project

```text
socra project update <id> [options]
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Project id, e.g. proj_… |

### Options

| Option | Input | Description |
| --- | --- | --- |
| `--status` | Value | New status: active or suspended |

## socra project delete

Delete a project by id

```text
socra project delete <id>
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `id` | Yes | Project id, e.g. proj_… |

## Next step

Return to the [Projects overview](/docs/project).

---

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