feat: completion + README — polish and docs

README.md

@@ -0,0 +1,48 @@
+# ry — Multi-Cloud CLI
+
+A `gh`-style CLI for managing cloud resources across providers.
+
+## Install
+
+```bash
+go install git.yoresee.cc/nightstar/ry/cmd/ry@latest
+```
+
+## Quick Start
+
+```bash
+ry provider add rainyun
+# Enter your API key when prompted
+
+ry server list
+ry server start <id>
+ry server vnc <id>
+```
+
+## Commands
+
+- `ry provider` — manage cloud providers (add, use, list)
+- `ry server` — manage cloud servers (list, get, start, stop, reboot, reinstall, reset-password, vnc)
+- `ry domain` — manage domains and DNS records
+- `ry storage` — manage object storage and buckets
+- `ry billing` — view orders
+- `ry config` — manage configuration (show, set, path)
+- `ry completion` — shell completion for bash/zsh/fish
+
+## Global Flags
+
+| Flag | Description |
+|------|-------------|
+| `-p, --provider` | Override cloud provider |
+| `-o, --output`   | Output format: table, json, yaml |
+| `--raw`          | Raw API response |
+| `--debug`        | Debug output |
+
+## Supported Providers
+
+- **雨云 (Rainyun)** — full support
+- More coming soon
+
+## Config
+
+`~/.config/ry/config.toml`