hashname-cli

Generate deterministic human-readable names from any input — hashes, UUIDs, IPs, commit SHAs, anything.

Same input always produces the same name. Like Docker container names, but for everything.

Install

pip install hashname-cli

Usage

# Basic naming
hashname name "abc123"              # → keen-spark
hashname name "192.168.1.1"        # → golden-reef

# More words for uniqueness
hashname name "abc123" -w 3        # → keen-cosmic-spark

# Capitalize
hashname name "abc123" -c          # → Keen-Spark

# Custom separator
hashname name "abc123" -s "_"      # → keen_spark

# Multiple names from one input
hashname name "server" -n 5

# Batch processing
hashname batch id1 id2 id3
echo -e "hash1\nhash2" | hashname batch

# JSON output
hashname name "abc123" --json

# Verify determinism
hashname verify "abc123"

# Word list stats
hashname stats

Why?

• Log readability: Replace a4995e18227e62fa with bold-ember
• Quick identification: Same hash = same name, every time
• No collisions needed: It's a label, not a UUID
• Agent-friendly: --json output, predictable CLI

For AI Agents

See SKILL.md for agent-optimized documentation.