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

# grant

> Manage Entire access grants and organization membership.

Manage Entire access grants and organization membership.

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

Grants are managed at three levels: membership in an [organization](/cli-reference/org), access to a [project](/cli-reference/project), and access to a [repository](/cli-reference/repo).

A **grantee** is addressed as a provider-qualified handle, such as `github:alice`, or as an account ULID. Orgs, projects, and repositories are addressed by name or ULID.

Every subcommand accepts `--json` to print raw JSON instead of a table. Under `grant repo`, every subcommand also accepts `--project PROJECT` (the owning project by name or ULID). This flag is required whenever `REPO` is a name.

<Note>
  Access to a [GitHub mirror](/guides/repositories/mirrors) follows GitHub collaborator permissions and syncs hourly, rather than being managed with `entire grant`. See [Mirror Access and Permissions](/guides/repositories/mirror-access-and-permissions).
</Note>

## grant org

Manage organization membership.

### `entire grant org add`

Add a member to an org.

```bash theme={null}
entire grant org add ORG GRANTEE [flags]
```

| Flag          | Description                                                    |
| ------------- | -------------------------------------------------------------- |
| `--role ROLE` | Org role: `owner`, `admin`, or `member`. Defaults to `member`. |

```bash theme={null}
entire grant org add acme github:alice --role admin
```

### `entire grant org list`

List org members.

```bash theme={null}
entire grant org list ORG [flags]
```

### `entire grant org remove`

Remove a member from an org.

```bash theme={null}
entire grant org remove ORG GRANTEE
```

```bash theme={null}
entire grant org remove acme github:alice
```

## grant project

Manage project access.

### `entire grant project add`

Grant a user access to a project.

```bash theme={null}
entire grant project add PROJECT GRANTEE --role ROLE [flags]
```

| Flag          | Description                                             |
| ------------- | ------------------------------------------------------- |
| `--role ROLE` | Project role: `reader`, `writer`, or `admin`. Required. |

```bash theme={null}
entire grant project add widgets github:alice --role writer
```

### `entire grant project list`

List project members.

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

### `entire grant project remove`

Revoke a grantee's access to a project.

```bash theme={null}
entire grant project remove PROJECT GRANTEE
```

```bash theme={null}
entire grant project remove widgets github:alice
```

## grant repo

Manage repository access.

### `entire grant repo add`

Grant a user access to a repository.

```bash theme={null}
entire grant repo add REPO GRANTEE --role ROLE [flags]
```

| Flag          | Description                                          |
| ------------- | ---------------------------------------------------- |
| `--role ROLE` | Repo role: `reader`, `writer`, or `admin`. Required. |

```bash theme={null}
entire grant repo add web github:alice --project acme --role writer
```

### `entire grant repo list`

List repository grants.

```bash theme={null}
entire grant repo list REPO [flags]
```

### `entire grant repo remove`

Revoke a grantee's access to a repository.

```bash theme={null}
entire grant repo remove REPO GRANTEE [flags]
```

```bash theme={null}
entire grant repo remove web github:alice --project acme
```

## Continue With

<CardGroup cols={2}>
  <Card title="repo visibility" icon="eye" href="/cli-reference/repo#entire-repo-visibility-set">
    Make a repository readable by all authenticated Entire users.
  </Card>

  <Card title="Mirror Access and Permissions" icon="lock" href="/guides/repositories/mirror-access-and-permissions">
    Understand GitHub-synced access for mirrors.
  </Card>
</CardGroup>