diff --git a/README.md b/README.md
index 4248848c..c155eb00 100644
--- a/README.md
+++ b/README.md
@@ -10,11 +10,11 @@
 <br />
 
 [![PyPI](https://img.shields.io/pypi/v/pythinker-code?style=for-the-badge&logo=pypi&logoColor=white&color=2563eb&label=pythinker-code&cacheSeconds=60)](https://pypi.org/project/pythinker-code/)
+[![Downloads](https://img.shields.io/pepy/dt/pythinker-code?style=for-the-badge&logo=python&logoColor=white&color=16a34a&label=downloads)](https://pepy.tech/projects/pythinker-code)
 [![Python](https://img.shields.io/badge/Python-3.12%2B-3776ab?style=for-the-badge&logo=python&logoColor=white)](https://github.com/Pythoughts-labs/pythinker-code/blob/main/pyproject.toml)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-16a34a.svg?style=for-the-badge)](https://github.com/Pythoughts-labs/pythinker-code/blob/main/LICENSE)
 [![CI](https://img.shields.io/github/actions/workflow/status/Pythoughts-labs/pythinker-code/ci-pythinker-cli.yml?branch=main&label=CI&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/Pythoughts-labs/pythinker-code/actions/workflows/ci-pythinker-cli.yml?query=branch%3Amain)
 
-[![PyPI Downloads](https://static.pepy.tech/personalized-badge/pythinker-code?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/pythinker-code)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-f59e0b.svg?style=flat-square&logo=ruff&logoColor=white)](https://docs.astral.sh/ruff/)
 [![ACP ready](https://img.shields.io/badge/ACP-ready-7c3aed.svg?style=flat-square)](https://github.com/agentclientprotocol/agent-client-protocol)
 [![MCP tools](https://img.shields.io/badge/MCP-tools-0891b2.svg?style=flat-square)](https://modelcontextprotocol.io/)
@@ -374,6 +374,10 @@ For hosted Pythinker models or ACP terminal auth:
 pythinker login
 ```
 
+<div align="center">
+<img src="https://raw.githubusercontent.com/Pythoughts-labs/pythinker-code/main/docs/media/setup.png" alt="Pythinker login provider picker" width="860">
+</div>
+
 Z.AI exposes two independent OpenAI-compatible routes. Choose the route that owns your key;
 both may coexist, and Pythinker never infers, migrates, falls back, or retries across them:
 
diff --git a/docs/media/setup.png b/docs/media/setup.png
index a0414b98..7c72fd0f 100644
Binary files a/docs/media/setup.png and b/docs/media/setup.png differ
diff --git a/docs/media/shell-mode.gif b/docs/media/shell-mode.gif
index da651f07..403e8d0e 100644
Binary files a/docs/media/shell-mode.gif and b/docs/media/shell-mode.gif differ