claude-china 0.2.1__tar.gz

claude_china-0.2.1/PKG-INFO

@@ -0,0 +1,256 @@
+Metadata-Version: 2.4
+Name: claude-china
+Version: 0.2.1
+Summary: Claude China: AI coding profiles and a desktop launcher
+License: MIT
+Project-URL: Homepage, https://github.com/invoker-bot/Claude-China
+Project-URL: Repository, https://github.com/invoker-bot/Claude-China
+Project-URL: Issues, https://github.com/invoker-bot/Claude-China/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=5.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: desktop
+Requires-Dist: pywebview>=6; extra == "desktop"
+Requires-Dist: psutil>=5.9; extra == "desktop"
+Requires-Dist: pystray>=0.19.5; extra == "desktop"
+Requires-Dist: Pillow>=9; extra == "desktop"
+
+# Claude China
+
+Switch between profiles for AI coding tools and launch the right CLI with the
+right environment.
+
+`claude-china` gives each profile its own provider, endpoint, credentials,
+proxy, and default arguments. The `claudec` command then starts Claude Code,
+OpenAI Codex, or Grok using that profile.
+
+Repository: [invoker-bot/Claude-China](https://github.com/invoker-bot/Claude-China)
+· PyPI: [claude-china](https://pypi.org/project/claude-china/)
+· CLI: `claudec`
+
+## Features
+
+- Manage multiple profiles from one command-line interface
+- Support API-key and isolated login/credential profiles
+- Configure a custom endpoint and proxy for each profile
+- Forward arguments to the underlying AI CLI
+- Set per-profile default arguments such as `--model`
+- Upgrade the supported AI CLIs through npm
+- Optional Windows and macOS desktop launcher
+
+## Installation
+
+Install the CLI from PyPI:
+
+```bash
+python -m pip install claude-china
+```
+
+For local development, install the checkout in editable mode:
+
+```bash
+python -m pip install -e .
+```
+
+The optional desktop launcher is installed with:
+
+```bash
+python -m pip install "claude-china[desktop]"
+```
+
+Requirements:
+
+- Python 3.9 or later
+- At least one supported AI CLI installed and available on `PATH`
+- Node.js and npm for `claudec upgrade`
+- Windows or macOS for the optional desktop launcher
+
+### Upgrading from code-ai / AI Launcher
+
+The 0.2 series renames the distribution from `ai-code-switcher` to `claude-china`,
+the command from `code-ai` to `claudec`, and the desktop app to **Claude China**.
+The Python module is now `claude_china` (`python -m claude_china.cli`).
+
+Quit the old launcher from its tray menu, then run:
+
+```bash
+python -m pip install --upgrade "claude-china[desktop]"
+claudec desktop install
+claudec desktop run
+```
+
+For CLI-only use, install `claude-china` without the extra. Existing profiles,
+login directories, desktop settings and the single-instance lock continue to
+use `~/.code-ai/`; no credentials need to be copied. Installing the desktop
+shortcut replaces the old **AI Launcher** shortcuts on Windows and macOS.
+You can then remove the old distribution with `python -m pip uninstall ai-code-switcher`.
+Old PyPI releases remain available for existing installations.
+
+## Quick start
+
+Create a profile interactively, then launch it:
+
+```bash
+claudec add
+claudec list
+claudec show my-claude
+claudec run my-claude
+```
+
+Arguments after the profile name are forwarded to the underlying CLI:
+
+```bash
+claudec run my-claude -p "Review this repository"
+claudec run my-codex --model o3
+claudec run my-grok --help
+```
+
+Useful commands:
+
+```text
+claudec list                         List configured profiles
+claudec add                          Add a profile interactively
+claudec show <profile>               Show profile details
+claudec remove <profile>             Remove a profile
+claudec upgrade                      Upgrade Claude, Codex, and Grok CLIs
+claudec --version                    Show the installed version
+claudec --help                       Show command help
+```
+
+The supported AI CLIs are:
+
+- Claude Code: `@anthropic-ai/claude-code`
+- OpenAI Codex: `@openai/codex`
+- Grok: `@xai-official/grok`
+
+`claudec upgrade` also refreshes the Grok binary in each login profile's
+credentials directory. Grok stores a separate binary under `GROK_HOME/bin`, so
+updating only the global npm package can leave a login profile running an old
+version. The upgrade enables npm install scripts and verifies the actual binary
+version in the default home and every login home; an unchanged or missing binary
+causes the command to fail. Restart running Grok sessions after upgrading.
+
+For Grok, `claudec run` prefers the official package in the active npm global
+prefix, so an older native installation earlier on `PATH` cannot shadow the
+package updated by `claudec upgrade`. Native installations remain supported
+when the npm package is absent. Login credentials still use the profile's own
+`GROK_HOME`.
+
+## Profiles and configuration
+
+Profiles are stored in `~/.code-ai/config.yaml`. Use API mode when the profile
+should provide a token or API key. Use login mode when the CLI should use an
+isolated credentials directory.
+
+Example configuration:
+
+```yaml
+profiles:
+  claude-api:
+    name: claude-api
+    type: claude
+    mode: api
+    base_url: https://api.anthropic.com
+    token: sk-ant-...
+    default_args:
+      - --model
+      - claude-sonnet-4-5
+
+  codex-login:
+    name: codex-login
+    type: codex
+    mode: login
+    credentials_path: ~/.codex-profiles/work
+    proxy: http://127.0.0.1:7890
+
+  grok-api:
+    name: grok-api
+    type: grok
+    mode: api
+    base_url: https://api.x.ai
+    api_key: xai-...
+```
+
+Login profiles isolate credentials through the provider-specific environment
+variables used by the CLIs. API profiles set the corresponding endpoint and
+authentication variables for the selected provider.
+
+Keep tokens and personal configuration out of source control.
+
+### Default launch arguments
+
+`default_args` can be a YAML list or a single string:
+
+```yaml
+profiles:
+  claude-api:
+    name: claude-api
+    type: claude
+    default_args: "--model claude-sonnet-4-5"
+```
+
+Profile defaults are appended after command-line arguments. This lets a
+profile pin a value such as `--model` when the CLI uses the last occurrence of
+a flag. Skip profile defaults for one launch with:
+
+```bash
+claudec run --no-default-args claude-api --model claude-opus-4-5
+```
+
+## Claude Buddy
+
+Claude profiles can have a deterministic companion card generated from the
+profile name:
+
+```bash
+claudec roll-claude-buddy claude-api
+claudec roll-claude-buddy claude-api --name capybara
+claudec roll-claude-buddy claude-api --type legendary
+```
+
+## Desktop launcher
+
+The optional desktop launcher provides a graphical interface for detected
+Claude and Codex desktop apps. It is supported on Windows and macOS.
+
+```bash
+python -m pip install "claude-china[desktop]"
+claudec desktop install       # create or recreate the shortcut
+claudec desktop run           # open the launcher
+claudec desktop uninstall     # remove the shortcut
+```
+
+Only one launcher runs per user. Opening the shortcut or running
+`claudec desktop run` again restores and brings the existing window forward.
+Closing the window hides it in the system tray (the menu bar on macOS).
+Click the tray icon or choose **打开 Claude China** to reopen the window;
+choose **退出** from the tray menu to exit the launcher completely.
+
+The launcher uses the terracotta **Claude China** mark for its window, shortcut,
+tray and footer. The tray/menu-bar and footer marks briefly breathe and turn
+when the launcher opens or an action runs, then return to rest. Shortcut and
+window-title icons stay static. See the [icon preview](docs/branding/preview.html)
+and [asset notes](docs/branding/README.md).
+
+On Windows, the launcher and its shortcuts share a taskbar identity. Icon files
+use a content-based filename so new artwork gets a fresh Shell cache entry.
+After upgrading, run `claudec desktop install` and restart the launcher to
+refresh existing shortcuts and the taskbar icon.
+
+Desktop settings are stored separately in `~/.code-ai/desktop.yaml`. The
+launcher can check the system proxy and apply common or per-application
+environment variables; per-application values take precedence.
+
+## Development
+
+Run the test suite and build the distribution locally with:
+
+```bash
+python -m pytest tests/ -q
+python -m build
+```
+
+## License
+
+MIT

claude_china-0.2.1/README.md

@@ -0,0 +1,238 @@
+# Claude China
+
+Switch between profiles for AI coding tools and launch the right CLI with the
+right environment.
+
+`claude-china` gives each profile its own provider, endpoint, credentials,
+proxy, and default arguments. The `claudec` command then starts Claude Code,
+OpenAI Codex, or Grok using that profile.
+
+Repository: [invoker-bot/Claude-China](https://github.com/invoker-bot/Claude-China)
+· PyPI: [claude-china](https://pypi.org/project/claude-china/)
+· CLI: `claudec`
+
+## Features
+
+- Manage multiple profiles from one command-line interface
+- Support API-key and isolated login/credential profiles
+- Configure a custom endpoint and proxy for each profile
+- Forward arguments to the underlying AI CLI
+- Set per-profile default arguments such as `--model`
+- Upgrade the supported AI CLIs through npm
+- Optional Windows and macOS desktop launcher
+
+## Installation
+
+Install the CLI from PyPI:
+
+```bash
+python -m pip install claude-china
+```
+
+For local development, install the checkout in editable mode:
+
+```bash
+python -m pip install -e .
+```
+
+The optional desktop launcher is installed with:
+
+```bash
+python -m pip install "claude-china[desktop]"
+```
+
+Requirements:
+
+- Python 3.9 or later
+- At least one supported AI CLI installed and available on `PATH`
+- Node.js and npm for `claudec upgrade`
+- Windows or macOS for the optional desktop launcher
+
+### Upgrading from code-ai / AI Launcher
+
+The 0.2 series renames the distribution from `ai-code-switcher` to `claude-china`,
+the command from `code-ai` to `claudec`, and the desktop app to **Claude China**.
+The Python module is now `claude_china` (`python -m claude_china.cli`).
+
+Quit the old launcher from its tray menu, then run:
+
+```bash
+python -m pip install --upgrade "claude-china[desktop]"
+claudec desktop install
+claudec desktop run
+```
+
+For CLI-only use, install `claude-china` without the extra. Existing profiles,
+login directories, desktop settings and the single-instance lock continue to
+use `~/.code-ai/`; no credentials need to be copied. Installing the desktop
+shortcut replaces the old **AI Launcher** shortcuts on Windows and macOS.
+You can then remove the old distribution with `python -m pip uninstall ai-code-switcher`.
+Old PyPI releases remain available for existing installations.
+
+## Quick start
+
+Create a profile interactively, then launch it:
+
+```bash
+claudec add
+claudec list
+claudec show my-claude
+claudec run my-claude
+```
+
+Arguments after the profile name are forwarded to the underlying CLI:
+
+```bash
+claudec run my-claude -p "Review this repository"
+claudec run my-codex --model o3
+claudec run my-grok --help
+```
+
+Useful commands:
+
+```text
+claudec list                         List configured profiles
+claudec add                          Add a profile interactively
+claudec show <profile>               Show profile details
+claudec remove <profile>             Remove a profile
+claudec upgrade                      Upgrade Claude, Codex, and Grok CLIs
+claudec --version                    Show the installed version
+claudec --help                       Show command help
+```
+
+The supported AI CLIs are:
+
+- Claude Code: `@anthropic-ai/claude-code`
+- OpenAI Codex: `@openai/codex`
+- Grok: `@xai-official/grok`
+
+`claudec upgrade` also refreshes the Grok binary in each login profile's
+credentials directory. Grok stores a separate binary under `GROK_HOME/bin`, so
+updating only the global npm package can leave a login profile running an old
+version. The upgrade enables npm install scripts and verifies the actual binary
+version in the default home and every login home; an unchanged or missing binary
+causes the command to fail. Restart running Grok sessions after upgrading.
+
+For Grok, `claudec run` prefers the official package in the active npm global
+prefix, so an older native installation earlier on `PATH` cannot shadow the
+package updated by `claudec upgrade`. Native installations remain supported
+when the npm package is absent. Login credentials still use the profile's own
+`GROK_HOME`.
+
+## Profiles and configuration
+
+Profiles are stored in `~/.code-ai/config.yaml`. Use API mode when the profile
+should provide a token or API key. Use login mode when the CLI should use an
+isolated credentials directory.
+
+Example configuration:
+
+```yaml
+profiles:
+  claude-api:
+    name: claude-api
+    type: claude
+    mode: api
+    base_url: https://api.anthropic.com
+    token: sk-ant-...
+    default_args:
+      - --model
+      - claude-sonnet-4-5
+
+  codex-login:
+    name: codex-login
+    type: codex
+    mode: login
+    credentials_path: ~/.codex-profiles/work
+    proxy: http://127.0.0.1:7890
+
+  grok-api:
+    name: grok-api
+    type: grok
+    mode: api
+    base_url: https://api.x.ai
+    api_key: xai-...
+```
+
+Login profiles isolate credentials through the provider-specific environment
+variables used by the CLIs. API profiles set the corresponding endpoint and
+authentication variables for the selected provider.
+
+Keep tokens and personal configuration out of source control.
+
+### Default launch arguments
+
+`default_args` can be a YAML list or a single string:
+
+```yaml
+profiles:
+  claude-api:
+    name: claude-api
+    type: claude
+    default_args: "--model claude-sonnet-4-5"
+```
+
+Profile defaults are appended after command-line arguments. This lets a
+profile pin a value such as `--model` when the CLI uses the last occurrence of
+a flag. Skip profile defaults for one launch with:
+
+```bash
+claudec run --no-default-args claude-api --model claude-opus-4-5
+```
+
+## Claude Buddy
+
+Claude profiles can have a deterministic companion card generated from the
+profile name:
+
+```bash
+claudec roll-claude-buddy claude-api
+claudec roll-claude-buddy claude-api --name capybara
+claudec roll-claude-buddy claude-api --type legendary
+```
+
+## Desktop launcher
+
+The optional desktop launcher provides a graphical interface for detected
+Claude and Codex desktop apps. It is supported on Windows and macOS.
+
+```bash
+python -m pip install "claude-china[desktop]"
+claudec desktop install       # create or recreate the shortcut
+claudec desktop run           # open the launcher
+claudec desktop uninstall     # remove the shortcut
+```
+
+Only one launcher runs per user. Opening the shortcut or running
+`claudec desktop run` again restores and brings the existing window forward.
+Closing the window hides it in the system tray (the menu bar on macOS).
+Click the tray icon or choose **打开 Claude China** to reopen the window;
+choose **退出** from the tray menu to exit the launcher completely.
+
+The launcher uses the terracotta **Claude China** mark for its window, shortcut,
+tray and footer. The tray/menu-bar and footer marks briefly breathe and turn
+when the launcher opens or an action runs, then return to rest. Shortcut and
+window-title icons stay static. See the [icon preview](docs/branding/preview.html)
+and [asset notes](docs/branding/README.md).
+
+On Windows, the launcher and its shortcuts share a taskbar identity. Icon files
+use a content-based filename so new artwork gets a fresh Shell cache entry.
+After upgrading, run `claudec desktop install` and restart the launcher to
+refresh existing shortcuts and the taskbar icon.
+
+Desktop settings are stored separately in `~/.code-ai/desktop.yaml`. The
+launcher can check the system proxy and apply common or per-application
+environment variables; per-application values take precedence.
+
+## Development
+
+Run the test suite and build the distribution locally with:
+
+```bash
+python -m pytest tests/ -q
+python -m build
+```
+
+## License
+
+MIT

claude_china-0.2.1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-china"
+version = "0.2.1"
+description = "Claude China: AI coding profiles and a desktop launcher"
+readme = {file = "README.md", content-type = "text/markdown"}
+license = {text = "MIT"}
+requires-python = ">=3.9"
+dependencies = [
+    "pyyaml>=5.0",
+    "typer>=0.9.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/invoker-bot/Claude-China"
+Repository = "https://github.com/invoker-bot/Claude-China"
+Issues = "https://github.com/invoker-bot/Claude-China/issues"
+
+[project.optional-dependencies]
+desktop = ["pywebview>=6", "psutil>=5.9", "pystray>=0.19.5", "Pillow>=9"]
+
+[project.scripts]
+claudec = "claude_china.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["claude_china*"]
+
+[tool.setuptools.package-data]
+claude_china = ["desktop/ui/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

claude_china-0.2.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claude_china-0.2.1/src/claude_china/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"