divekit auth

Manage authentication for GitLab remotes

Synopsis

Manage authentication tokens for GitLab instances.

This command provides an interactive menu to manage GitLab authentication, or can be used non-interactively with arguments. Tokens are stored securely in the system keychain if supported by the operating system.

Subcommands

  register    Register a new GitLab instance interactively
  unset       Remove a configured GitLab instance

Modes

  Interactive (no arguments):
    Launches a menu to list, add, update, or remove instances.

  Non-interactive:
    divekit auth [hostname]        Update token for existing instance
    divekit auth [hostname] [url]  Register new instance with URL

Usage

divekit auth [hostname] [url] [flags]

Examples

# Launch interactive authentication menu
divekit auth

# Update token for an existing instance (prompts for token)
divekit auth gitnrw

# Update token without exposing it in process arguments
divekit auth gitnrw --token file:///absolute/path/to/token

# Register a new GitLab instance
divekit auth gitnrw https://gitlab.git.nrw/

# Interactive registration wizard
divekit auth register

# Remove a configured instance
divekit auth unset gitnrw

Flags

--token string   Set the access token directly or read it from file:///absolute/path

Inherited Flags

-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)