Uuid Tool

Generate universally unique identifiers (UUIDs) in versions v1, v4, v5, v7, and nil format, with bulk generation and namespace-based deterministic IDs.

BIN@dinghaibin

Install

openclaw skills install @dinghaibin/uuid-tool

UUID Tool — Universal Unique Identifier Generator

Generate, parse, and inspect UUIDs across multiple standards. Supports time-based (v1, v7), random (v4), and namespace-based (v5) UUIDs for distributed systems, database keys, and idempotency tokens.

Quick Start

bash

# Generate a random UUID (v4)
uuid-tool --generate v4

# Generate a time-ordered UUID (v7, good for DB indexing)
uuid-tool --generate v7

# Generate 10 UUIDs at once
uuid-tool --generate v4 --count 10

Usage

bash

uuid-tool [COMMAND] [OPTIONS]

Commands:
  --generate VERSION   Generate UUIDs (v1, v4, v5, v7)
  --parse UUID         Parse and inspect a UUID string
  --nil                Generate the nil UUID (00000000-...)
  --from-name TEXT     Deterministic UUID v5 from namespace + name

Options:
  --count N            Number of UUIDs to generate (default: 1)
  --namespace NS       Namespace for v5: "dns", "url", "oid", "x500", or custom
  --upper              Output uppercase hex
  --no-hyphens         Remove dashes from output
  --json               Output as JSON array

Examples

bash

# Time-based UUID v1
uuid-tool --generate v1

# Time-ordered UUID v7 (good for DB primary keys)
uuid-tool --generate v7

# Deterministic UUID from a domain name
uuid-tool --from-name "example.com" --namespace dns

# Parse and inspect
uuid-tool --parse "550e8400-e29b-41d4-a716-446655440000"

# Batch generate 100 UUIDs in compact format
uuid-tool --generate v4 --count 100 --no-hyphens

Features

4 UUID versions: v1 (time), v4 (random), v5 (SHA-1 namespace), v7 (time-ordered)
Bulk generation: Up to 1000 UUIDs in one call
Deterministic v5: Same namespace + name → same UUID every time
Parse & decode: Extract timestamp, version, variant from any UUID
Compact mode: Remove dashes for space-constrained usage
JSON output: Easy integration with scripts and APIs
Nil UUID: Generate or validate against the all-zero nil UUID