---
title: "Users & Teams in the CLI"
canonical: https://trickest.com/docs/developer-tools/cli/users
description: "List users, manage teams and roles, and resolve your identity from the trickest CLI."
---

# Users & Teams in the CLI

The **`users`** family covers organization membership: listing users, teams, roles,
and invites. For **your own** identity, prefer `trickest auth whoami` or
`trickest users me`.

<Info>
Access control concepts: [Roles & Permissions](/docs/key-concepts/roles-and-permissions).
UI guides: [Teams and roles](/docs/using-the-app/users-access-management/teams-and-roles) and
[Inviting users](/docs/using-the-app/users-access-management/inviting-users).
</Info>

## Top-level commands

| Command | Description |
|---|---|
| `users ls` | List users in the org |
| `users get <email-or-id>` | One user |
| `users me` | Currently authenticated user |
| `users teams` | Team subcommands |
| `users roles` | Role subcommands |
| `users invites` | Invite subcommands |

<Note>
Running `trickest users teams` or `trickest users roles` **without** a subcommand
prints group help and exits with code **1** — that is not success.
</Note>

## `users me` / `users ls`

```bash
trickest users me
```
```json
{"id":214,"email":"you@org.com","username":"you"}
```

```bash
trickest users ls
```
```json
[{"id":214,"email":"you@org.com","username":"you","date_joined":"2024-02-19T10:41:07Z","mfa_enabled":true,"is_active":true}]
```

Use numeric `id` values when filtering audit logs (`audit ls --user 214`).

## `trickest users teams`

| Subcommand | Description |
|---|---|
| `users teams ls` | List teams |
| `users teams get <name-or-id>` | Team details |
| `users teams create <name>` | Create a team |
| `users teams rm <name-or-id>` | Delete a team |

```bash
trickest users teams ls
trickest users teams create "Red Team"
```

## `trickest users roles`

| Subcommand | Description |
|---|---|
| `users roles ls` | List roles |
| `users roles update <user-id> <role>` | Change a user's role |

```bash
trickest users roles ls
trickest users roles update 8 admin
```

## `trickest users invites`

Run `trickest users invites --help` for invite create/list/revoke subcommands.

## Related

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/docs/developer-tools/cli/authentication">
    Tokens, login, and `auth whoami`.
  </Card>
  <Card title="Notifications & Audit" icon="bell" href="/docs/developer-tools/cli/notifications-audit">
    Audit entries reference actor emails and user IDs.
  </Card>
</CardGroup>

---
_Markdown source of https://trickest.com/docs/developer-tools/cli/users._