docs: add copilot docs and 0.2.0 changelog

- Record 0.2.0 release notes with copilot coverage
- Remove version pin from README install snippets
- Document copilot endpoints and auth across guides

Author: CaddyGlow

CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-01-05
+
+### Added
+
+- GitHub Copilot now documented across the site (index, quickstart, API usage, authentication) with endpoints, auth flow, and model examples.
+- Claude `/claude/v1/models` endpoint for model discovery.
+
+### Changed
+
+- Provider list and auth guidance now explicitly include Copilot alongside Claude and Codex.
+- Temperature validation guards requests before forwarding to upstream APIs.
+- Release workflow accepts `version`, `skip_tests`, and `pypi_only` inputs and gates steps accordingly.
+
+### Fixed
+
+- Tool-call streaming in SDK mode now works for both SSE and dict outputs with correct indexing.
+- Race conditions and first-message loss in streaming broadcasts addressed; orphaned `tool_result` blocks sanitized.
+- Null `temperature` values stripped from Claude API requests to avoid upstream validation errors.
+
+### Note
+
+- Includes all fixes and improvements from pre-release tags `0.2.0a2–0.2.0a4`.
+
+## [0.2.0a4] - 2026-01-05
+
+### Changed
+
+- Release workflow now accepts `version`, `skip_tests`, and `pypi_only` inputs and gates test/package/docker/release steps accordingly.
+- Workflow can check out an explicit ref and tag releases with the provided version.
+
 ## [0.2.0a3] - 2026-01-04
 
 ### Fixed

README.md

@@ -156,14 +156,14 @@ To install the latest stable release without cloning the repository, use `uvx`
 to grab the published wheel and launch the CLI:
 
 ```bash
-uvx --with "ccproxy-api[all]==0.2.0" ccproxy serve --port 8000
+uvx --with "ccproxy-api[all]" ccproxy serve --port 8000
 ```
 
 If you prefer `pipx`, install the package (optionally with extras) and use the
 local shim:
 
 ```bash
-pipx install "ccproxy-api[all]==0.2.0"
+pipx install "ccproxy-api[all]"
 ccproxy serve  # default on localhost:8000
 ```
 

docs/getting-started/quickstart.md

@@ -192,6 +192,15 @@ print(response.choices[0].message.content)
 - `POST /api/codex/v1/chat/completions` - Standard OpenAI endpoint
 - `GET /api/codex/v1/models` - List available models
 
+### Copilot Plugin (`/copilot`)
+- `POST /copilot/v1/chat/completions` - OpenAI chat completions via GitHub Copilot
+- `POST /copilot/v1/responses` - OpenAI Responses API
+- `POST /copilot/v1/messages` - Anthropic messages (adapter translated)
+- `POST /copilot/v1/embeddings` - OpenAI embeddings
+- `GET /copilot/v1/models` - List available models
+- `GET /copilot/usage` - Copilot usage snapshot
+- `GET /copilot/token` - Copilot token status
+
 ## Monitoring & Debugging
 
 ### Health Check

docs/index.md

@@ -1,12 +1,15 @@
 # CCProxy API Server
 
-`ccproxy` is a local reverse proxy server that provides unified access to multiple AI providers through a plugin-based architecture. It supports Anthropic Claude and OpenAI Codex through dedicated provider plugins, allowing you to use your existing subscriptions without separate API key billing.
+`ccproxy` is a local reverse proxy server that provides unified access to multiple
+AI providers through a plugin-based architecture. It supports Anthropic Claude,
+OpenAI Codex, and GitHub Copilot through dedicated provider plugins, allowing
+you to use your existing subscriptions without separate API key billing.
 
 ## Architecture
 
 CCProxy uses a modern plugin system that provides:
 
-- **Provider Plugins**: Handle specific AI providers (Claude SDK, Claude API, Codex)
+- **Provider Plugins**: Handle specific AI providers (Claude SDK, Claude API, Codex, Copilot)
 - **System Plugins**: Add functionality like pricing, logging, monitoring, and permissions
 - **Unified API**: Consistent interface across all providers
 - **Format Translation**: Seamless conversion between Anthropic and OpenAI formats
@@ -48,6 +51,20 @@ Provides access to OpenAI's APIs (Responses and Chat Completions) through OAuth2
 
 All plugins support both Anthropic and OpenAI-compatible API formats for requests and responses, including streaming.
 
+### Copilot Plugin (`/copilot`)
+Adds GitHub Copilot as a provider with OAuth device flow support and GitHub
+flavored auxiliary endpoints.
+
+**Endpoints:**
+- `POST /copilot/v1/chat/completions` - OpenAI Chat Completions via Copilot
+- `POST /copilot/v1/responses` - OpenAI Responses API
+- `POST /copilot/v1/messages` - Anthropic messages (adapter translated)
+- `POST /copilot/v1/embeddings` - OpenAI embeddings
+- `GET /copilot/v1/models` - List Copilot-exposed models
+- `GET /copilot/usage` - GitHub Copilot usage snapshot
+- `GET /copilot/token` - Copilot token status
+- `GET /copilot/health` - Plugin health (OAuth and gh CLI detection)
+
 ## Installation
 
 ```bash

docs/user-guide/api-usage.md

@@ -51,6 +51,7 @@ curl -X POST http://localhost:8000/claude/v1/messages \
 Claude SDK Mode: http://localhost:8000/claude/sdk/v1/
 Claude API Mode: http://localhost:8000/claude/v1/
 Codex (OpenAI):  http://localhost:8000/codex/v1/
+Copilot (GitHub): http://localhost:8000/copilot/v1/
 ```
 
 ### Chat Completions
@@ -97,6 +98,26 @@ curl -X POST http://localhost:8000/codex/v1/responses \
       {"role": "user", "content": [{"type": "text", "text": "Hello!"}]}
     ]
   }'
+
+# OpenAI Chat Completions via Copilot
+curl -X POST http://localhost:8000/copilot/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-4-copilot",
+    "messages": [
+      {"role": "user", "content": "Hello from Copilot!"}
+    ]
+  }'
+
+# OpenAI Responses API via Copilot
+curl -X POST http://localhost:8000/copilot/v1/responses \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gpt-4-copilot",
+    "input": [
+      {"role": "user", "content": [{"type": "text", "text": "Hello!"}]}
+    ]
+  }'
 ```
 ```
 

docs/user-guide/authentication.md

@@ -5,7 +5,8 @@
 CCProxy API handles authentication in multiple layers:
 1. **Claude Authentication**: Your Claude subscription credentials for accessing Claude AI
 2. **OpenAI/Codex Authentication**: Your ChatGPT Plus credentials for accessing the Response API
-3. **API Authentication**: Optional token authentication for securing access to the proxy endpoints
+3. **GitHub Copilot Authentication**: Your GitHub account credentials for Copilot chat/completions
+4. **API Authentication**: Optional token authentication for securing access to the proxy endpoints
 
 ## Important: Authentication Methods
 
@@ -32,6 +33,13 @@ CCProxy supports multiple authentication methods with separate credential storag
 - **Requirements**: Active ChatGPT Plus subscription
 - **Credential Reuse**: Automatically uses existing Codex CLI credentials if available
 
+### GitHub Copilot Authentication
+- **Used by**: `ccproxy auth login copilot` (device flow) and Copilot endpoints
+- **Storage**: `$HOME/.config/copilot/credentials.json`
+- **Purpose**: Authenticates for GitHub Copilot chat, responses, embeddings, and usage APIs
+- **Requirements**: GitHub Copilot access (individual, business, or enterprise)
+- **Credential Reuse**: Detects existing GitHub CLI authentication when present
+
 ## Authentication Commands
 
 ### Claude Authentication Commands
@@ -101,6 +109,32 @@ Shows authentication status for all providers:
 - Claude SDK credentials
 - Claude API credentials  
 - OpenAI/Codex credentials
+- GitHub Copilot credentials
+
+### GitHub Copilot Authentication Commands
+
+Manage your Copilot device-flow credentials:
+
+#### Login
+```bash
+# Enable Copilot provider first (if disabled)
+ccproxy config copilot --enable
+
+# Start GitHub device flow for Copilot
+ccproxy auth login copilot
+```
+
+Flow:
+1. Prints a GitHub device code and verification URL.
+2. Complete authentication in the browser.
+3. Stores credentials in `$HOME/.config/copilot/credentials.json`.
+4. Automatically refreshes Copilot tokens when they near expiry.
+
+#### View Copilot Status
+```bash
+ccproxy auth status copilot
+```
+Shows token expiry, detected plan (individual/business/enterprise), and whether a Copilot token is present.
 
 #### View Detailed OpenAI Credentials
 ```bash