​
Overview

Create a new NimbleTools account using Clerk OAuth. This command opens your browser for account creation and stores authentication credentials locally.

​
Syntax

ntcli auth signup [options]

​
Options

​
-p, --port
number
Port for local callback server. Default: 41247
​
-t, --timeout
number
Authentication timeout in milliseconds. Default: 60000 (60 seconds)
​
-v, --verbose
boolean
Enable verbose output to show detailed signup flow

​
Examples

​
Basic Signup

ntcli auth signup
This will:
  1. Start a local callback server
  2. Open your browser to the NimbleTools signup page
  3. Guide you through account creation
  4. Store the new credentials locally

​
Custom Port

ntcli auth signup --port 3000

​
Verbose Signup

ntcli auth signup --verbose

ntcli auth signup

​
Signup vs Login

CommandPurposeWhen to Use
ntcli auth signupCreate new accountFirst time using NimbleTools
ntcli auth loginSign in to existing accountAlready have an account
Both commands support the same OAuth providers and options.

​
Account Creation Process

1

Start Local Server

ntcli starts a local callback server for OAuth
2

Open Browser

Your browser opens to the NimbleTools signup page
3

Choose Auth Method

Select email/password, Google, GitHub, or other providers
4

Complete Registration

Fill out account details and verify email if required
5

Store Credentials

Authentication tokens are stored securely locally

auth login

Sign in to existing account

auth status

Check authentication status