docs(readme): add badges, family table, credits

Author: obarlik

README.md

@@ -6,6 +6,11 @@
    └──────────────────────────────────────────────────┘
 ```
 
+[![PyPI](https://img.shields.io/pypi/v/codechu-cli.svg)](https://pypi.org/project/codechu-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/codechu-cli.svg)](https://pypi.org/project/codechu-cli/)
+[![CI](https://github.com/codechu/cli-py/actions/workflows/ci.yml/badge.svg)](https://github.com/codechu/cli-py/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
 > *Colors, progress bars, spinners, prompts — terminal UX in one import.*
 
 # codechu-cli
@@ -440,6 +445,33 @@ Style names (the keys in `SPINNER_STYLES`, `BAR_STYLES`) are part of the
 requires a deprecation cycle (warn for one minor version, then remove
 on the next). Family names and tag names follow the same rule.
 
+## Codechu family
+
+Companion libraries from the Codechu Python ecosystem:
+
+| Library | Purpose |
+|---------|---------|
+| [codechu-fmt](https://pypi.org/project/codechu-fmt/) | Human-readable formatting — sizes, durations, rates, percent |
+| [codechu-meter](https://pypi.org/project/codechu-meter/) | Timing primitives — Stopwatch, ETA, percentile, histogram |
+| [codechu-spark](https://pypi.org/project/codechu-spark/) | Unicode sparklines, mini bar charts, heatmaps |
+| [codechu-events](https://pypi.org/project/codechu-events/) | Thread-safe multi-channel pub/sub bus with replay |
+| [codechu-xdg](https://pypi.org/project/codechu-xdg/) | XDG Base Directory helpers, vendor-namespaced |
+| [codechu-treeviz](https://pypi.org/project/codechu-treeviz/) | Tree visualization — treemap, sunburst, icicle, flame |
+| [codechu-fs](https://pypi.org/project/codechu-fs/) | Filesystem primitives — atomic write, XDG trash, safe walk |
+| [codechu-term](https://pypi.org/project/codechu-term/) | Terminal capability detection, alt buffer, raw mode |
+| [codechu-color](https://pypi.org/project/codechu-color/) | Color palettes, WCAG contrast, color-blind variants |
+| [codechu-treedata](https://pypi.org/project/codechu-treedata/) | N-ary tree data structures and algorithms |
+| [codechu-log](https://pypi.org/project/codechu-log/) | Structured logging — context, JSON, rotation, redaction |
+| [codechu-i18n](https://pypi.org/project/codechu-i18n/) | Internationalization — locale, plural rules, RTL |
+| [codechu-ipc](https://pypi.org/project/codechu-ipc/) | Local IPC — Unix socket, FIFO, JSON-line protocol |
+| [codechu-config](https://pypi.org/project/codechu-config/) | Schema-driven config — atomic save, migrations |
+
+## Credits
+
+- Spinner glyph styles adapted from [cli-spinners](https://github.com/sindresorhus/cli-spinners)
+- ANSI escape conventions per ECMA-48
+- Inspiration from [rich](https://github.com/Textualize/rich) and [questionary](https://github.com/tmbo/questionary); codechu-cli stays stdlib-only with line-oriented output
+
 ## License
 
 MIT — see [LICENSE](LICENSE).