> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.com/llms.txt
> Use this file to discover all available pages before exploring further.

# project

> Manage Entire projects.

Manage Entire projects.

```bash theme={null}
entire project COMMAND
```

A project is owned by an [organization](https://docs.entire.com/cli-reference/org.md) or by an account, and in turn owns [repositories](https://docs.entire.com/cli-reference/repo.md). To manage who can reach a project, use [`entire project grant`](https://docs.entire.com/cli-reference/grant#entire-project-grant).

Use a project's name or ULID with `get` and `delete`. Most subcommands accept `--json` to print raw JSON instead of a table; `delete` and `grant remove` do not.

## `entire project create`

Create a project owned by an org or an account.

```bash theme={null}
entire project create NAME --owner OWNER [flags]
```

`--owner` names the owning org (by name or ULID) or account (as `github:handle`, or by ULID). `--owner-type` selects which of the two you mean.

| Flag | Description |
| - | - |
| `--owner OWNER` | Owning org (name or ULID), or account (`github:handle` or ULID). Required. |
| `--owner-type TYPE` | Owner kind: `org` or `account`. Defaults to `org`. |
| `--region SLUG` | Jurisdiction slug. Defaults to the server's home jurisdiction. |

```bash theme={null}
# Project under an org, by name
entire project create widgets --owner acme --owner-type org

# Project owned by an account, by handle
entire project create widgets --owner github:alice --owner-type account
```

## `entire project list`

List projects you can see.

```bash theme={null}
entire project list [flags]
```

| Flag | Description |
| - | - |
| `--name NAME` | Filter by exact project name. |
| `--org ORG` | List projects owned by this org, by name or ULID. |

## `entire project get`

Show a project by name or ULID.

```bash theme={null}
entire project get PROJECT [flags]
```

## `entire project delete`

Delete a project by name or ULID.

```bash theme={null}
entire project delete PROJECT [flags]
```

| Flag | Description |
| - | - |
| `-f, --force` | Skip the confirmation prompt. |
| `-y, --yes` | Skip the confirmation prompt. Alias for `--force`. |

## `entire project agent setup`

Allow a service account to run the project's [self-hosted Agents](https://docs.entire.com/guides/trails/agents.md#run-agents-on-your-own-machine). Run it from a checkout of a repository the Agents review. It gives the service account read access to that repository and prints the next command to run. You need permission to manage the Entire project.

```bash theme={null}
entire project agent setup [flags]
```

| Flag | Description |
| - | - |
| `--name NAME` | Create a service account with this name. |
| `--service-account ACCOUNT` | Use an existing service account, by `svc_` ID or `project/name`. |
| `-y, --yes` | Skip the confirmation prompt. |

Pass exactly one of `--name` or `--service-account`.

## `entire project agent serve`

Run self-hosted Agent jobs on this machine until stopped. Set `ENTIRE_TOKEN` to a secret of the service account from `setup`.

```bash theme={null}
ENTIRE_TOKEN="$(cat agent.secret)" entire project agent serve [flags]
```

| Flag | Description |
| - | - |
| `--once` | Handle at most one job, then exit. |
| `--poll-interval DURATION` | Time between checks for new jobs. Default `5s`. |

## Continue With

> [card] [repo](https://docs.entire.com/cli-reference/repo.md)
>
> Create and manage the repositories a project owns.

> [card] [grant](https://docs.entire.com/cli-reference/grant.md)
>
> Grant and revoke project access.
