Metadata-Version: 2.4
Name: hashname-cli
Version: 0.1.0
Summary: Generate deterministic human-readable names from any input
Author-email: Marcus <marcus.builds.things@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/hashname
Keywords: cli,hash,name,deterministic,human-readable
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Dynamic: license-file

# 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

```bash
pip install hashname-cli
```

## Usage

```bash
# 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](SKILL.md) for agent-optimized documentation.
