divekit members on Divekit

divekit members add

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Add members to a distribution before creating or updating repositories.

The command writes a new members file with new users appended, preserves UUIDs for existing groups, and updates the distribution config to point at the new file.

Input Sources

 Interactive (default):
 Opens the multiline member input prompt when no arguments, --members-file,
 or stdin input are provided.

 Arguments:
 Provide one or more usernames as positional arguments.

 File:
 Use --members-file to read usernames to add from a file.

 Stdin:
 Pipe usernames into the command.

Usage

divekit members add [member...] [flags]

Examples

# Add two users to the next distribution
divekit members add -d ST2M5 alice bob

# Add users listed in a file
divekit members add -d ST2M5 --members-file additional-members.txt

# Preview additions without changing config.json or members files
divekit members add -d ST2M5 --members-file additional-members.txt --dry-run

Flags

--dry-run Preview added members without writing a new members file
 --members-file string Path to a file with member names to add (one per line)

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members exclude

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Exclude configured members from a distribution before creating repositories.

The command writes a new members file with the excluded users removed, preserves UUIDs for all remaining groups, drops empty groups, and updates the distribution config to point at the new file.

Input Sources

 Arguments:
 Provide one or more usernames as positional arguments.

 File:
 Use --members-file to read usernames to exclude from a file.

 Stdin:
 Pipe usernames into the command.

Usage

divekit members exclude [member...] [flags]

Examples

# Exclude two users from the next distribution
divekit members exclude -d ST2M4 alice bob

# Exclude users listed in a file
divekit members exclude -d ST2M4 --members-file excluded.txt

# Preview exclusions without changing config.json or members files
divekit members exclude -d ST2M4 --members-file excluded.txt --dry-run

Flags

--dry-run Preview excluded members without writing a new members file
 --members-file string Path to a file with member names to exclude (one per line)
 -r, --remote string Remote repository URL (e.g. GitLab instance)
 -t, --token string GitLab token or token file path (file:///...)

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members filter

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Filter members in a distribution before creating or updating repositories.

Use –include to keep only listed users. Use –exclude to remove listed users. The aliases retain, keep, and intersect use –include semantics.

Input Sources

 Interactive (default):
 Opens the multiline member input prompt when no arguments, --members-file,
 or stdin input are provided.

 Arguments:
 Provide one or more usernames as positional arguments.

 File:
 Use --members-file to read usernames from a file.

 Stdin:
 Pipe usernames into the command.

Usage

divekit members filter [member...] [flags]

Examples

# Keep only users listed in a file
divekit members filter -d ST2M5 --include --members-file passed-members.txt

# Equivalent include aliases
divekit members keep -d ST2M5 --members-file passed-members.txt
divekit members retain -d ST2M5 --members-file passed-members.txt

# Remove listed users
divekit members filter -d ST2M5 --exclude --members-file skipped-members.txt

# Preview filtering without changing config.json or members files
divekit members filter -d ST2M5 --include --members-file passed-members.txt --dry-run

Flags

--dry-run Preview filtered members without writing a new members file
 --exclude Remove listed members
 --include Keep only listed members
 --members-file string Path to a file with member names to filter (one per line)
 -r, --remote string Remote repository URL (e.g. GitLab instance)
 -t, --token string GitLab token or token file path (file:///...)

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members list

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Show configured members and their current GitLab roles

Usage

divekit members list [flags]

Flags

--offline Show configured members without checking GitLab roles
 -r, --remote string Remote repository URL (e.g. GitLab instance)
 -t, --token string GitLab token or token file path (file:///...)

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members role

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Update GitLab access level for members in a distribution.

Changes the permission level for all project members across all repositories in a distribution by default. Pass specific members to update only those users. Downgrades also revoke overprivileged Project Access Tokens on affected work projects. Useful for adjusting access after deadlines or during different phases of an assignment.

Access Levels

 guest Can view project but not clone/download
 reporter Can clone and view issues
 developer Can push to non-protected branches
 maintainer Full access including protected branches

Use Cases

Restrict access after submission deadline (developer → guest)
Grant access for collaboration phase (guest → developer)
Emergency lockdown of all repositories

Usage

divekit members role [access-level] [member...] [flags]

Examples

# Set all members to developer access
divekit members role -d ST2M4 developer

# Restrict all members to guest (read-only)
divekit members role -d ST2M4 guest

# Using flag instead of positional argument
divekit members role -d ST2M4 --access-level reporter

# Re-enable specific members only
divekit members role -d ST2M4 developer alice bob

# Re-enable specific members with an interactive access-level prompt
divekit members role -d ST2M4 --member alice --member bob

# Interactive access level selection
divekit members role -d ST2M4

# Deprecated alias, still supported
divekit role -d ST2M4 developer alice bob

Flags

--access-level string New access level: guest|reporter|developer|maintainer
 --member strings GitLab username to update; may be used multiple times

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members show

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Show groups matching a member name or UUID

Usage

divekit members show [member-or-uuid] [flags]

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members status

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Show member assignment status without changing anything

Usage

divekit members status [flags]

Flags

-r, --remote string Remote repository URL (e.g. GitLab instance)
 -t, --token string GitLab token or token file path (file:///...)

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members sync

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Synchronize configured members with distributed work repositories

Usage

divekit members sync [flags]

Flags

-r, --remote string Remote repository URL (e.g. GitLab instance)
 -t, --token string GitLab token or token file path (file:///...)

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members

divekit members validate

Mon, 01 Jan 0001 00:00:00 +0000

Synopsis

Validate the configured members file

Usage

divekit members validate [flags]

Inherited Flags

-d, --distribution string Distribution name (required or prompted)
 -l, --loglevel string log level (debug, info, warn, error, fatal) (default "info")
 --no-index skip project index update
 --non-interactive run in non-interactive mode (fails if interactive input is required)
 -y, --yes assume yes/default for all prompts (non-interactive with automatic defaults)

Parent Command

divekit members