Metadata-Version: 2.4
Name: colorconv-cli
Version: 0.1.0
Summary: Convert between color formats - hex, RGB, HSL, and color names
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/colors
Project-URL: Repository, https://github.com/marcusbuildsthings-droid/colors
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/colors/issues
Author-email: Marcus <marcus.builds.things@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: cli,color,converter,hex,hsl,palette,rgb
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: click>=8.0
Description-Content-Type: text/markdown

# colorcli

Convert between color formats - hex, RGB, HSL, and CSS named colors.

```bash
pip install colorcli
```

## Usage

```bash
# Convert any color format
colors convert "#ff5733"
colors convert "rgb(255, 87, 51)"
colors convert coral

# Specific format conversions
colors hex "#ff5733"
colors rgb 255 87 51
colors hsl 11 100 60
colors name coral

# Generate palettes
colors palette "#ff5733" 5 --type analogous
colors palette coral 3 --type triadic
colors palette "#336699" --type complementary

# Utility commands
colors blend "#ff0000" "#0000ff"
colors contrast "#ff5733"
colors names              # List all CSS color names
```

## Commands

| Command | Description |
|---------|-------------|
| `convert COLOR` | Convert any color to all formats |
| `hex HEX` | Convert hex to RGB/HSL |
| `rgb R G B` | Convert RGB to hex/HSL |
| `hsl H S L` | Convert HSL to hex/RGB |
| `name NAME` | Look up CSS named color |
| `names` | List all 140 CSS named colors |
| `palette COLOR [COUNT]` | Generate color palette |
| `blend COLOR1 COLOR2` | Mix two colors |
| `contrast COLOR` | Suggest text color for background |
| `random-gradient COLOR` | Generate CSS gradient |

## Palette Types

- `complementary` - Opposite on color wheel
- `analogous` - Adjacent colors (default)
- `triadic` - Three colors 120° apart
- `tetradic` - Four colors 90° apart
- `split` - Split-complementary
- `shades` - Darker versions
- `tints` - Lighter versions

## JSON Output

All commands support `--json` for machine-readable output:

```bash
colors convert "#ff5733" --json
```

```json
{
  "hex": "#ff5733",
  "rgb": {"r": 255, "g": 87, "b": 51},
  "rgb_string": "rgb(255, 87, 51)",
  "hsl": {"h": 11, "s": 100, "l": 60},
  "hsl_string": "hsl(11, 100%, 60%)",
  "name": null
}
```

## For AI Agents

See [SKILL.md](SKILL.md) for agent-optimized documentation.

## License

MIT
