ccoding 0.1.0__tar.gz

ccoding-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # 用于 OIDC 免密发布
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - name: Build
+        run: uv build
+
+      - name: Publish
+        run: uv publish

ccoding-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyd
+*.so
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test/typing/cache
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+
+# Editor/OS
+.DS_Store
+.idea/
+.vscode/
+
+# Tooling
+.serena/
+
+# Env files
+.env
+.claude/

ccoding-0.1.0/CLAUDE.md

@@ -0,0 +1,42 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+**ccoding** — 基于 curses 的 Claude Code 启动器 TUI，用于配置 LiteLLM proxy / CLI Proxy API 的模型网关参数，并直接启动 `claude` 命令。PyPI 包名 `ccoding`，Python import 包名 `ccode`，命令行入口 `ccode`。
+
+## 常用命令
+
+```bash
+uv sync                        # 安装/同步依赖
+uv run ccode                   # 运行
+uv run python -m ccode         # 模块方式运行（调试）
+uv build                       # 构建 wheel / sdist
+```
+
+无测试框架，无 lint 配置。
+
+## 架构
+
+`src layout`，包在 `src/ccode/`，模块职责如下：
+
+- **`config.py`** — 所有持久化逻辑。配置文件路径 `~/.ccode/config.json`。`toggles` 字段存储任意环境变量键值对（`dict[str, str]`）。提供 `load_env_schema()` / `env_schema_keys()` / `env_schema_description()` / `env_schema_enum()` 四个函数，从 `env_schema.json` 读取已知变量的元数据。
+- **`api.py`** — 无状态函数层：HTTP 拉取 `/v1/models`、构建启动环境变量 `build_env()`、调用 `subprocess.run(["claude", ...])` 启动 claude。
+- **`logo.py`** — LOGOS 数据（3 种 ASCII 字体）及 4 种渲染风格函数（wave / pulse / glitch / rain），接收独立参数，不依赖 `CursesApp`。
+- **`ui.py`** — `CursesApp` 类，持有全部 UI 状态。配置界面的 field 列表由 `_config_fields()` 动态构建（`base_url`、`api_key`、每个 toggle key、`__add__` 新增行），支持运行时增删 toggle。新增 toggle 时 key 输入框实时展示候选列表，Tab 键补全，候选来源为 `env_schema.json` 的 217 个已知变量。
+- **`cli.py`** — 入口，`main(argv)` 构造 `CursesApp` 并调用 `curses.wrapper`。
+- **`env_schema.json`** — 从官方文档生成的 Claude Code 环境变量 JSON Schema，含 `description` 和 `enum` 字段，供 UI 补全和提示使用。更新 claude code 版本后如需同步新变量，手动编辑此文件的 `properties` 节。
+
+## 关键数据流
+
+1. `load_config()` 读取 `~/.ccode/config.json`，toggles 值统一为字符串。
+2. 主界面 → `fetch_models()` 拉取可用模型 → 用户选择 opus/sonnet/haiku 的 owned_by 和 model_id。
+3. 启动时 `build_env()` 将 `base_url`、`api_key`、model id、toggles 全部注入环境变量，执行 `claude`。
+4. 配置界面 `ESC` 自动保存后刷新模型列表。
+
+## 注意事项
+
+- `TOGGLE_LABELS` 常量已移除，配置界面 toggles 完全动态，从 `config["toggles"]` 渲染。
+- toggles 旧格式（`int` 值 0/1）在 `load_config()` 中自动迁移为字符串。
+- Windows 上 curses 依赖 `windows-curses`，在 `pyproject.toml` 中已通过 platform marker 声明。

ccoding-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 8DE4732A
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ccoding-0.1.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: ccoding
+Version: 0.1.0
+Summary: Curses-based Claude Code launcher
+Project-URL: Homepage, https://github.com/8DE4732A/ccode
+Project-URL: Repository, https://github.com/8DE4732A/ccode
+Project-URL: Issues, https://github.com/8DE4732A/ccode/issues
+Author: 8de4732a
+License: MIT License
+        
+        Copyright (c) 2025 8DE4732A
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: claude,claude-code,curses,launcher,tui
+Classifier: Environment :: Console :: Curses
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Requires-Dist: windows-curses; sys_platform == 'win32'
+Description-Content-Type: text/markdown
+
+# CCode Launcher (Curses UI)
+
+这是一个基于 curses 的 Claude Code 启动器，提供键盘全操作的终端界面，用于配置 Base URL、API Key、模型选择和常用开关，并直接启动 `claude` 命令。
+
+工具的目的是方便启动claude code时快速选择想要使用的模型。模型网关可以使用litellm proxy 或者 CLI Proxy API
+
+![](screenshot.png)
+## 功能特点
+
+- 终端 curses UI，键盘全操作
+- 主界面选择 OPUS / SONNET / HAIKU 的 owned_by 与 model_id
+- 配置界面编辑 Base URL / API Key 与常用开关
+- 自动保存配置到 `~/.ccode/config.json`
+- 直接启动 `claude` 并传递额外参数
+- 动画 Logo（颜色渐变 / 流光 / 轻微波浪）
+
+## 安装
+
+推荐使用 [uv](https://github.com/astral-sh/uv) 安装为全局工具：
+
+```bash
+uv tool install ccoding
+```
+
+或使用 [pipx](https://pipx.pypa.io)：
+
+```bash
+pipx install ccoding
+```
+
+安装后直接运行：
+
+```bash
+ccode
+ccode --chrome   # 传递额外参数给 claude
+```
+
+## 开发者运行方式
+
+需要 Python >=3.10，仅依赖标准库（Windows 额外需要 `windows-curses`，安装时自动处理）。
+
+```bash
+git clone https://github.com/8DE4732A/ccode
+cd ccode
+uv sync
+uv run ccode
+```
+
+## 快捷键（主界面）
+
+- `↑ / ↓`：切换 OPUS / SONNET / HAIKU 行
+- `← / →`：切换 owned_by / model_id 字段
+- `a / d`：循环切换当前字段的可选项
+- `b`：刷新模型列表
+- `c`：进入配置界面
+- `Enter`：校验并启动 `claude`
+- `q`：退出
+
+> 提示：首次使用需要先在配置界面设置 Base URL 与 API Key，然后返回主界面按 `b` 获取模型列表。
+
+## 快捷键（配置界面）
+
+- `↑ / ↓`：移动字段焦点
+- `Enter / Space`：切换开关项
+- 文本输入：编辑 BASE_URL / API_KEY
+- `ESC`：自动保存并返回主界面
+
+## 配置文件
+
+配置自动保存在：
+
+```
+~/.ccode/config.json
+```
+
+示例结构：
+
+```json
+{
+  "base_url": "http://127.0.0.1:8317",
+  "api_key": "",
+  "models": {
+    "opus": {"owned_by": null, "id": null},
+    "sonnet": {"owned_by": null, "id": null},
+    "haiku": {"owned_by": null, "id": null}
+  },
+  "toggles": {
+    "CLAUDE_CODE_ENABLE_TELEMETRY": "0",
+    "DISABLE_COST_WARNINGS": "1",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+  }
+}
+```
+
+## 工作原理
+
+1. 从 `~/.ccode/config.json` 读取配置（首次运行自动生成）。
+2. 根据 Base URL + API Key 拉取模型列表。
+3. 选择 OPUS / SONNET / HAIKU 的 owned_by / model_id。
+4. 启动 `claude`，并注入相关环境变量。
+
+## 许可证
+
+MIT

ccoding-0.1.0/README.md

@@ -0,0 +1,104 @@
+# CCode Launcher (Curses UI)
+
+这是一个基于 curses 的 Claude Code 启动器，提供键盘全操作的终端界面，用于配置 Base URL、API Key、模型选择和常用开关，并直接启动 `claude` 命令。
+
+工具的目的是方便启动claude code时快速选择想要使用的模型。模型网关可以使用litellm proxy 或者 CLI Proxy API
+
+![](screenshot.png)
+## 功能特点
+
+- 终端 curses UI，键盘全操作
+- 主界面选择 OPUS / SONNET / HAIKU 的 owned_by 与 model_id
+- 配置界面编辑 Base URL / API Key 与常用开关
+- 自动保存配置到 `~/.ccode/config.json`
+- 直接启动 `claude` 并传递额外参数
+- 动画 Logo（颜色渐变 / 流光 / 轻微波浪）
+
+## 安装
+
+推荐使用 [uv](https://github.com/astral-sh/uv) 安装为全局工具：
+
+```bash
+uv tool install ccoding
+```
+
+或使用 [pipx](https://pipx.pypa.io)：
+
+```bash
+pipx install ccoding
+```
+
+安装后直接运行：
+
+```bash
+ccode
+ccode --chrome   # 传递额外参数给 claude
+```
+
+## 开发者运行方式
+
+需要 Python >=3.10，仅依赖标准库（Windows 额外需要 `windows-curses`，安装时自动处理）。
+
+```bash
+git clone https://github.com/8DE4732A/ccode
+cd ccode
+uv sync
+uv run ccode
+```
+
+## 快捷键（主界面）
+
+- `↑ / ↓`：切换 OPUS / SONNET / HAIKU 行
+- `← / →`：切换 owned_by / model_id 字段
+- `a / d`：循环切换当前字段的可选项
+- `b`：刷新模型列表
+- `c`：进入配置界面
+- `Enter`：校验并启动 `claude`
+- `q`：退出
+
+> 提示：首次使用需要先在配置界面设置 Base URL 与 API Key，然后返回主界面按 `b` 获取模型列表。
+
+## 快捷键（配置界面）
+
+- `↑ / ↓`：移动字段焦点
+- `Enter / Space`：切换开关项
+- 文本输入：编辑 BASE_URL / API_KEY
+- `ESC`：自动保存并返回主界面
+
+## 配置文件
+
+配置自动保存在：
+
+```
+~/.ccode/config.json
+```
+
+示例结构：
+
+```json
+{
+  "base_url": "http://127.0.0.1:8317",
+  "api_key": "",
+  "models": {
+    "opus": {"owned_by": null, "id": null},
+    "sonnet": {"owned_by": null, "id": null},
+    "haiku": {"owned_by": null, "id": null}
+  },
+  "toggles": {
+    "CLAUDE_CODE_ENABLE_TELEMETRY": "0",
+    "DISABLE_COST_WARNINGS": "1",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+  }
+}
+```
+
+## 工作原理
+
+1. 从 `~/.ccode/config.json` 读取配置（首次运行自动生成）。
+2. 根据 Base URL + API Key 拉取模型列表。
+3. 选择 OPUS / SONNET / HAIKU 的 owned_by / model_id。
+4. 启动 `claude`，并注入相关环境变量。
+
+## 许可证
+
+MIT

ccoding-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "ccoding"
+version = "0.1.0"
+description = "Curses-based Claude Code launcher"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+authors = [{ name = "8de4732a" }]
+keywords = ["claude", "claude-code", "launcher", "curses", "tui"]
+classifiers = [
+    "Environment :: Console :: Curses",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+dependencies = [
+    "windows-curses; sys_platform == 'win32'",
+]
+
+[project.urls]
+Homepage = "https://github.com/8DE4732A/ccode"
+Repository = "https://github.com/8DE4732A/ccode"
+Issues = "https://github.com/8DE4732A/ccode/issues"
+
+[project.scripts]
+ccode = "ccode.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ccode"]

ccoding-0.1.0/src/ccode/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .cli import main
+
+__version__ = "0.1.0"
+
+__all__ = ["main", "__version__"]

ccoding-0.1.0/src/ccode/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

ccoding-0.1.0/src/ccode/api.py

@@ -0,0 +1,140 @@
+from __future__ import annotations
+
+import json
+import os
+import subprocess
+import urllib.error
+import urllib.request
+from typing import Any
+
+from .config import MODEL_KEYS, mask_secret
+
+
+def _truncate_body(text: str, max_len: int = 200) -> str:
+    return f"{text[:max_len]}..." if len(text) > max_len else text
+
+
+def fetch_models(base_url: str, api_key: str) -> list[dict[str, str]]:
+    url = f"{base_url.rstrip('/')}/v1/models"
+    headers = {"Authorization": f"Bearer {api_key}"}
+    request = urllib.request.Request(url, headers=headers)
+    try:
+        with urllib.request.urlopen(request, timeout=10) as response:
+            status = response.getcode()
+            body_bytes = response.read()
+    except urllib.error.HTTPError as exc:
+        body = ""
+        try:
+            if exc.fp is not None:
+                body = exc.fp.read().decode("utf-8", "replace").strip()
+        except Exception:
+            body = ""
+        message = _truncate_body(body) or "No response body"
+        raise RuntimeError(f"HTTP {exc.code}: {message}") from exc
+    except (urllib.error.URLError, OSError) as exc:
+        raise RuntimeError(f"Request failed: {exc}") from exc
+
+    if status != 200:
+        body = body_bytes.decode("utf-8", "replace").strip()
+        message = _truncate_body(body) or "No response body"
+        raise RuntimeError(f"HTTP {status}: {message}")
+
+    try:
+        payload = json.loads(body_bytes.decode("utf-8", "replace"))
+    except ValueError as exc:
+        raise RuntimeError("Invalid JSON response") from exc
+
+    data = payload.get("data")
+    if not isinstance(data, list):
+        raise RuntimeError("Response JSON missing data array")
+
+    models: list[dict[str, str]] = []
+    for item in data:
+        if not isinstance(item, dict):
+            continue
+        model_id = item.get("id")
+        owned_by = item.get("owned_by")
+        if isinstance(model_id, str) and isinstance(owned_by, str):
+            models.append({"id": model_id, "owned_by": owned_by})
+
+    return models
+
+
+def validate_models(config: dict[str, Any], models: list[dict[str, str]]) -> bool:
+    valid = {(item["owned_by"], item["id"]) for item in models}
+    changed = False
+    for key in MODEL_KEYS:
+        entry = config["models"].get(key, {})
+        owned_by = entry.get("owned_by")
+        model_id = entry.get("id")
+        if not owned_by or not model_id or (owned_by, model_id) not in valid:
+            if entry.get("owned_by") is not None or entry.get("id") is not None:
+                config["models"][key] = {"owned_by": None, "id": None}
+                changed = True
+    return changed
+
+
+def build_models_by_owner(
+    models_data: list[dict[str, str]] | None,
+) -> dict[str, list[str]]:
+    by_owner: dict[str, list[str]] = {}
+    for item in models_data or []:
+        owned_by = item.get("owned_by")
+        model_id = item.get("id")
+        if not isinstance(owned_by, str) or not isinstance(model_id, str):
+            continue
+        by_owner.setdefault(owned_by, []).append(model_id)
+    for owner in by_owner:
+        by_owner[owner] = sorted(by_owner[owner])
+    return by_owner
+
+
+def owner_options(models_by_owner: dict[str, list[str]]) -> list[str]:
+    return sorted(models_by_owner.keys())
+
+
+def model_options(models_by_owner: dict[str, list[str]], owner: str) -> list[str]:
+    return models_by_owner.get(owner, [])
+
+
+def build_env(config: dict[str, Any], masked: bool = False) -> dict[str, str]:
+    env = os.environ.copy()
+    base_url = config.get("base_url", "")
+    api_key = config.get("api_key", "")
+    env["ANTHROPIC_BASE_URL"] = base_url
+    env["ANTHROPIC_AUTH_TOKEN"] = mask_secret(api_key) if masked else api_key
+    for key in MODEL_KEYS:
+        entry = config["models"].get(key, {})
+        model_id = entry.get("id")
+        if model_id:
+            env[f"ANTHROPIC_DEFAULT_{key.upper()}_MODEL"] = model_id
+    for key, value in config.get("toggles", {}).items():
+        env[key] = str(value)
+    return env
+
+
+def validate_launch_requirements(config: dict[str, Any]) -> str | None:
+    base_url = config.get("base_url", "").strip()
+    api_key = config.get("api_key", "").strip()
+    if not base_url or not api_key:
+        return "Base URL and API key are required."
+    for key in MODEL_KEYS:
+        entry = config["models"].get(key, {})
+        if not entry.get("owned_by") or not entry.get("id"):
+            return "OPUS, SONNET, and HAIKU selections are required."
+    return None
+
+
+def launch_claude(config: dict[str, Any], args: list[str]) -> str | None:
+    base_url = config.get("base_url", "").strip()
+    api_key = config.get("api_key", "").strip()
+    if not base_url or not api_key:
+        return "Missing base URL or API key."
+    env = build_env(config, masked=False)
+    try:
+        subprocess.run(["claude", *args], check=True, env=env)
+    except FileNotFoundError:
+        return "Could not find 'claude' on PATH."
+    except subprocess.CalledProcessError as exc:
+        return f"claude exited with code {exc.returncode}."
+    return None

ccoding-0.1.0/src/ccode/cli.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+import curses
+import sys
+
+from .ui import CursesApp
+
+
+def main(argv: list[str] | None = None) -> None:
+    args = argv if argv is not None else sys.argv[1:]
+    app = CursesApp(args)
+    curses.wrapper(app.run)