CLI reference / Sign-in and account

CLI reference

Sign-in and account

wiele login, auth, onboarding and settings: sign in, finish onboarding and change your username or branch naming.

Sign in once per machine. The CLI keeps the session in the OS keychain, or in a file you choose with --credential-file. See Authentication for the full flow, including sign-in from an agent without a terminal.

wiele login

Sign in with a code sent to your email. Asks for the address unless --email is given.

wiele login [flags]
Flag Description
--email string Email address to send the code to.

wiele auth login

Sign in with a code sent to your email. Asks for the address unless --email is given.

wiele auth login [flags]
Flag Description
--email string Email address to send the code to.

wiele auth start

Send a sign-in code and print its challenge ID for auth verify. For an interactive sign-in, run wiele login.

wiele auth start [flags]
Flag Description
--email string Email address to send the code to.

wiele auth verify

Finish a sign-in started with auth start. Without a code, it prompts in a terminal.

wiele auth verify [flags] [<code>]
Argument Description
<code> Optional. Six-digit code from the email.
Flag Description
--challenge string Required. Challenge ID printed by auth start.
--code string Six-digit code from the email.
--code-stdin Read the code from piped standard input.

wiele auth status

Show the signed-in user, the session's expiry and your username.

wiele auth status [flags]

wiele auth logout

End the session on the server and delete it from this machine.

wiele auth logout [flags]

wiele onboarding status

Show whether you still need to create a first organization or accept invitations.

wiele onboarding status [flags]

wiele onboarding complete

Finish onboarding: create your first organization with --name, or accept invitations with --invitations.

wiele onboarding complete [flags]
Flag Description
--name string Name of the organization to create.
--slug string Slug for the new organization. Default: a generated org-... slug.
--invitations string Comma-separated invitation IDs to accept, from wiele onboarding status.
--idempotency-key string Required. UUIDv7 for this request. Unlike other commands, you must pass one.

wiele settings list

List your account settings: username and branch-name-template.

wiele settings list [flags]

wiele settings get

Read one account setting, or all of them.

wiele settings get [flags] [<key>]
Argument Description
<key> Optional. username or branch-name-template. Omit it for both.

wiele settings set

Change an account setting. A concurrent change fails instead of being overwritten.

wiele settings set [flags] <key> <value>
Argument Description
<key> username or branch-name-template.
<value> New value. A username is 1 to 32 lowercase letters, digits, _ or -, starting with a letter or digit. A template may use ${username}, ${date} and ${time}.

wiele settings reset

Reset an account setting to its default.

wiele settings reset [flags] <key>
Argument Description
<key> username or branch-name-template.