chore(release): publish as real-browser-cli

- Rename the PyPI distribution from browser-cli to real-browser-cli after PyPI rejected the original name as too similar to an existing project.
- Keep the installed console command as browser-cli so user-facing CLI usage remains unchanged.
- Add README-based package metadata, author information, and project URLs so PyPI renders a proper project description.
- Centralize the PyPI distribution name for importlib.metadata version lookups used by the CLI, doctor command, and remote user agent.
- Document uv tool install, optional fast extra installation, and upgrade commands.
- Bump package and extension metadata to 0.14.3 for the republished release.

browser_cli/cli.py

@@ -35,6 +35,7 @@ from browser_cli.commands.serve_http import cmd_serve_http
 from browser_cli.commands.watch import watch_group
 from browser_cli.commands.workspace import workspace_group
 from browser_cli.commands.raw import cmd_command
+from browser_cli.constants import PYPI_PACKAGE_NAME
 
 console = Console()
 
@@ -63,7 +64,7 @@ def _project_version() -> str:
     pass
 
   try:
-    return package_version("browser-cli")
+    return package_version(PYPI_PACKAGE_NAME)
   except PackageNotFoundError:
     return "unknown"
 

browser_cli/commands/doctor.py

@@ -11,7 +11,7 @@ from rich.table import Table
 
 from browser_cli.commands import handle_errors, client_from_ctx
 from browser_cli.client import active_browser_targets
-from browser_cli.constants import NATIVE_HOST_DIRS, NATIVE_HOST_NAME
+from browser_cli.constants import NATIVE_HOST_DIRS, NATIVE_HOST_NAME, PYPI_PACKAGE_NAME
 from browser_cli.platform import is_windows
 
 console = Console()
@@ -26,7 +26,7 @@ def _project_version() -> str:
     except OSError:
         pass
     try:
-        return package_version("browser-cli")
+        return package_version(PYPI_PACKAGE_NAME)
     except PackageNotFoundError:
         return "unknown"
 

browser_cli/constants.py

@@ -9,6 +9,7 @@ import os
 from pathlib import Path
 
 APP_NAME = "browser-cli"
+PYPI_PACKAGE_NAME = "real-browser-cli"
 RUNTIME_DIRNAME = ".browser_cli"
 DEFAULT_ALIAS = "default"
 

browser_cli/version_manager.py

@@ -1,6 +1,6 @@
 from importlib.metadata import version as _pkg_version
 
-from browser_cli.constants import MAX_MSG_BYTES, PROTOCOL_MIN_CLIENT
+from browser_cli.constants import MAX_MSG_BYTES, PROTOCOL_MIN_CLIENT, PYPI_PACKAGE_NAME
 
 def parse_version(v: str) -> tuple[int, ...]:
     try:
@@ -10,7 +10,7 @@ def parse_version(v: str) -> tuple[int, ...]:
 
 def get_installed_version() -> str:
     try:
-        return _pkg_version("browser-cli")
+        return _pkg_version(PYPI_PACKAGE_NAME)
     except Exception:
         return "0.0.0"