docs: beautify READMEs with emojis and badges

- Add shields.io badges (license, stars)
- Add emojis to section headers
- Add architecture diagram
- Add TIP and NOTE callouts
- Improve visual structure and formatting
- Cross-links between EN and PT-BR versions

Author: gustavodiasdev

README.md

@@ -1,19 +1,27 @@
-# opencode-qwen-auth
+# 🤖 Qwen Code OAuth Plugin for OpenCode
 
-OAuth authentication plugin for [OpenCode CLI](https://opencode.ai) that enables Qwen3-Coder models through your [qwen.ai](https://chat.qwen.ai) account with **2,000 free requests per day**.
+![License](https://img.shields.io/github/license/gustavodiasdev/opencode-qwen-auth)
+![GitHub stars](https://img.shields.io/github/stars/gustavodiasdev/opencode-qwen-auth)
 
-[Leia em Português](./README.pt-BR.md)
+**Authenticate OpenCode CLI with your qwen.ai account.** This plugin enables you to use Qwen3-Coder models with **2,000 free requests per day** - no API key or credit card required!
 
-## Features
+[🇧🇷 Leia em Português](./README.pt-BR.md)
 
-- **OAuth Device Flow** - Secure browser-based authentication (RFC 8628)
-- **Automatic Polling** - Automatically detects when you authorize in the browser
-- **2,000 req/day free** - No credit card required
-- **1M context window** - Models with 1 million token context windows
-- **Auto-refresh** - Automatically renews tokens when they expire
-- **qwen-code compatible** - Reuses existing credentials from `~/.qwen/oauth_creds.json`
+## ✨ Features
 
-## Installation
+- 🔐 **OAuth Device Flow** - Secure browser-based authentication (RFC 8628)
+- ⚡ **Automatic Polling** - No need to press Enter after authorizing
+- 🆓 **2,000 req/day free** - Generous free tier with no credit card
+- 🧠 **1M context window** - Models with 1 million token context
+- 🔄 **Auto-refresh** - Tokens renewed automatically before expiration
+- 🔗 **qwen-code compatible** - Reuses credentials from `~/.qwen/oauth_creds.json`
+
+## 📋 Prerequisites
+
+- [OpenCode CLI](https://opencode.ai) installed
+- A [qwen.ai](https://chat.qwen.ai) account (free to create)
+
+## 🚀 Installation
 
 ### 1. Add the plugin to OpenCode
 
@@ -41,49 +49,93 @@ Edit `~/.opencode/opencode.jsonc`:
 cd ~/.opencode && npm install
 ```
 
-### 3. Authenticate
+## 🔑 Usage
 
-Start OpenCode and select the **Qwen Code** provider:
+### 1. Login
 
 ```bash
-opencode
+opencode auth login
 ```
 
-Or via command line (select "Other" and type `qwen-code`):
+### 2. Select Provider
 
-```bash
-opencode auth login
-```
+Choose **"Other"** and type `qwen-code`
+
+### 3. Authenticate
 
-Choose **"Qwen Code (qwen.ai OAuth)"** and authorize in your browser.
+Select **"Qwen Code (qwen.ai OAuth)"**
 
-### 4. Use Qwen models
+- A browser window will open for you to authorize
+- The plugin automatically detects when you complete authorization
+- No need to copy/paste codes or press Enter!
+
+> [!TIP]
+> In the OpenCode TUI (graphical interface), the **Qwen Code** provider appears automatically in the provider list.
+
+## 🎯 Available Models
+
+| Model | Context | Max Output | Best For |
+|-------|---------|------------|----------|
+| `qwen3-coder-plus` | 1M tokens | 64K tokens | Complex coding tasks |
+| `qwen3-coder-flash` | 1M tokens | 64K tokens | Fast responses |
+
+### Using a specific model
 
 ```bash
 opencode --provider qwen-code --model qwen3-coder-plus
 ```
 
-## Available Models
-
-| Model | Context | Output | Description |
-|-------|---------|--------|-------------|
-| `qwen3-coder-plus` | 1M tokens | 64K tokens | Most capable coding model |
-| `qwen3-coder-flash` | 1M tokens | 64K tokens | Faster responses |
+## ⚙️ How It Works
 
-## How It Works
+```
+┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
+│   OpenCode CLI  │────▶│  qwen.ai OAuth   │────▶│  Qwen3-Coder    │
+│                 │◀────│  (Device Flow)   │◀────│  API            │
+└─────────────────┘     └──────────────────┘     └─────────────────┘
+```
 
-1. **Device Flow (RFC 8628)**: When logging in, the plugin opens your browser to `chat.qwen.ai`
-2. **Automatic Polling**: The plugin automatically detects when you authorize (no need to press Enter)
-3. **Storage**: Credentials are saved to `~/.qwen/oauth_creds.json` (compatible with qwen-code)
-4. **Auto-refresh**: Tokens are automatically renewed 30 seconds before expiration
+1. **Device Flow (RFC 8628)**: Opens your browser to `chat.qwen.ai` for authentication
+2. **Automatic Polling**: Detects authorization completion automatically
+3. **Token Storage**: Saves credentials to `~/.qwen/oauth_creds.json`
+4. **Auto-refresh**: Renews tokens 30 seconds before expiration
 
-## Usage Limits
+## 📊 Usage Limits
 
 | Plan | Rate Limit | Daily Limit |
 |------|------------|-------------|
 | Free (OAuth) | 60 req/min | 2,000 req/day |
 
-## Local Development
+> [!NOTE]
+> Limits reset at midnight UTC. For higher limits, consider using an API key from [DashScope](https://dashscope.aliyun.com).
+
+## 🔧 Troubleshooting
+
+### Token expired
+
+The plugin automatically renews tokens. If issues persist:
+
+```bash
+# Remove old credentials
+rm ~/.qwen/oauth_creds.json
+
+# Re-authenticate
+opencode auth login
+```
+
+### Provider not showing in `auth login`
+
+The `qwen-code` provider is added via plugin. In the `opencode auth login` command:
+
+1. Select **"Other"**
+2. Type `qwen-code`
+
+### Rate limit exceeded (429 errors)
+
+- Wait until midnight UTC for quota reset
+- Try using `qwen3-coder-flash` for faster, lighter requests
+- Consider [DashScope API](https://dashscope.aliyun.com) for higher limits
+
+## 🛠️ Development
 
 ```bash
 # Clone the repository
@@ -95,69 +147,52 @@ bun install
 
 # Type check
 bun run typecheck
+```
 
-# Local link in OpenCode
-# Edit ~/.opencode/package.json:
+### Local testing
+
+Edit `~/.opencode/package.json`:
+
+```json
 {
   "dependencies": {
-    "opencode-qwen-auth": "file:/absolute/path/to/opencode-qwen-auth"
+    "opencode-qwen-auth": "file:///absolute/path/to/opencode-qwen-auth"
   }
 }
+```
 
-# Reinstall
+Then reinstall:
+
+```bash
 cd ~/.opencode && npm install
 ```
 
-## Project Structure
+## 📁 Project Structure
 
 ```
 src/
-├── constants.ts        # Constants (OAuth endpoints, models)
+├── constants.ts        # OAuth endpoints, models config
 ├── types.ts            # TypeScript interfaces
-├── index.ts            # Main plugin
-├── cli.ts              # Standalone CLI (optional)
+├── index.ts            # Main plugin entry point
 ├── qwen/
-│   └── oauth.ts        # OAuth Device Flow + PKCE logic
+│   └── oauth.ts        # OAuth Device Flow + PKCE
 └── plugin/
     ├── auth.ts         # Credentials management
-    ├── client.ts       # Qwen API client
-    └── utils.ts        # Utilities
+    └── utils.ts        # Helper utilities
 ```
 
-## Troubleshooting
-
-### Token expired
-
-The plugin automatically renews tokens. If issues persist:
-
-```bash
-# Remove old credentials
-rm ~/.qwen/oauth_creds.json
-
-# Re-authenticate
-opencode auth login
-```
-
-### Provider not showing in `auth login`
-
-The `qwen-code` provider is added via plugin. In the `opencode auth login` command:
-1. Select **"Other"**
-2. Type `qwen-code`
-
-In the TUI (OpenCode graphical interface), the provider appears automatically.
-
-### Rate limit exceeded
-
-If you hit the daily limit (2,000 requests):
-- Wait until midnight UTC for quota reset
-- Consider using an API Key from [DashScope](https://dashscope.aliyun.com) for higher limits
-
-## Related Projects
+## 🔗 Related Projects
 
 - [qwen-code](https://github.com/QwenLM/qwen-code) - Official Qwen coding CLI
-- [OpenCode](https://opencode.ai) - AI CLI for development
+- [OpenCode](https://opencode.ai) - AI-powered CLI for development
 - [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) - Similar plugin for Google Gemini
 
-## License
+## 📄 License
 
 MIT
+
+---
+
+<p align="center">
+  Made with ❤️ for the OpenCode community
+</p>