---
title: stx projects
description: Create, list, and delete Syntext projects from the command line.
icon: folder
---

# stx projects

Manage Syntext projects without leaving your terminal. All subcommands require authentication — run [stx login](/cli/login) first.

## Usage

```bash
stx projects <subcommand> [options]
```

## Subcommands

| Subcommand | Description |
|------------|-------------|
| `create <name>` | Create a new project |
| `list` | List your projects |
| `delete <projectId>` | Delete a project (irreversible) |

## stx projects create

```bash
stx projects create "Acme Docs"
```

```
✔ Project created!

  ID:       prj_abc123
  Name:     Acme Docs
  Slug:     acme
  Docs URL: https://acme-docs.syntext.dev

  Connect this project to your local docs:
    stx connect prj_abc123
```

| Flag | Description |
|------|-------------|
| `--json` | Output result as JSON |

<Note>
Project creation is subject to your plan's limits. If you hit a limit, upgrade at [syntext.dev/settings/billing](https://syntext.dev/settings/billing).
</Note>

## stx projects list

```bash
stx projects list
```

```
✔ 2 projects

  Acme Docs (pro)
    ID:  prj_abc123
    URL: https://acme-docs.syntext.dev

  Internal Wiki (free)
    ID:  prj_def456
    URL: https://wiki-docs.syntext.dev
```

| Flag | Description |
|------|-------------|
| `--json` | Output projects as JSON |

## stx projects delete

```bash
stx projects delete prj_abc123 --confirm
```

| Flag | Description |
|------|-------------|
| `--confirm` | Required — acknowledges the action is irreversible |
| `--json` | Output result as JSON |

<Warning>
Deleting a project removes its deployed doc site, builds, and analytics permanently. There is no undo.
</Warning>

## Related

- [stx connect](/cli/connect) — link local docs to a project
- [stx login](/cli/login) — authenticate the CLI