codelux 0.1.0a2__tar.gz

codelux-0.1.0a2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codelux AI Initiative
+
+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.

codelux-0.1.0a2/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: codelux
+Version: 0.1.0a2
+Summary: Unified Provider management CLI for AI coding assistants
+License: MIT
+License-File: LICENSE
+Keywords: ai,llm,provider,claude,codex
+Author: Codelux AI Initiative
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: click (>=8.1.0,<9.0.0)
+Requires-Dist: cryptography (>=41,<47)
+Project-URL: Homepage, https://github.com/codelux-io/codelux
+Project-URL: Repository, https://github.com/codelux-io/codelux
+Description-Content-Type: text/markdown
+
+# Codelux
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Codelux is a command-line tool for managing LLM Provider configurations across AI coding
+assistants. It provides explicit Provider switching, recoverable local changes, and encrypted
+cross-machine synchronization.
+
+**Website and Provider API:** [https://codelux.io](https://codelux.io)
+
+## Capabilities
+
+- Provider management for Claude Code and Codex
+- Read-only configuration and health inspection
+- Snapshot-backed restoration of official configurations
+- Fail-closed recovery for incomplete local transactions
+- Encrypted offline export/import and OpenSSH-based synchronization
+- Explicit conflict handling for synchronized configuration and session data
+
+## Security model
+
+Codelux stores Provider credentials in local files protected by operating-system file permissions.
+These files are not encrypted at rest. They are not protected from processes running as the same
+user, privileged administrators, malware, compromised accounts, backups, or physical disk access.
+
+Cross-machine archives are encrypted with a user-provided password. Active client configuration is
+not applied on another machine unless the user explicitly requests it.
+
+See [SECURITY.md](SECURITY.md) for vulnerability reporting and security boundaries.
+
+## Installation
+
+Codelux is currently in alpha and has not been published to the production Python Package Index.
+Install the development checkout with:
+
+```bash
+python3 -m pip install -e .
+```
+
+## Usage
+
+```bash
+codelux version
+codelux status --client claude
+codelux list
+codelux add codelux-io --url https://codelux.io --client claude
+codelux switch codelux-io --client claude
+codelux switch official --client claude
+codelux recover --dry-run
+```
+
+Synchronization commands support explicit content selection:
+
+```bash
+codelux sync export --output codelux-sync.enc --providers --sessions
+codelux sync import codelux-sync.enc
+codelux sync push --ssh user@host.example --providers
+codelux sync pull --ssh user@host.example --providers
+```
+
+Use `--help` on any command to inspect its current options and safety prompts.
+
+## Development
+
+```bash
+python3 -m pip install . pytest==7.4.4 coverage==7.10.7
+coverage run -m pytest -q
+coverage report
+python scripts/check_public_repository.py
+```
+
+## License
+
+MIT
+
+# Codelux
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Codelux 是一个用于在多种 AI 编程助手之间管理大模型 Provider 配置的命令行工具，提供
+明确的 Provider 切换、可恢复的本地修改和加密跨机器同步。
+
+**官网与 Provider API：** [https://codelux.io](https://codelux.io)
+
+## 主要能力
+
+- 管理 Claude Code 和 Codex 的 Provider
+- 只读检查配置与健康状态
+- 通过快照恢复官方配置
+- 对未完成的本地事务执行失败关闭式恢复
+- 加密离线导入导出和基于 OpenSSH 的同步
+- 对同步配置和会话数据执行明确的冲突处理
+
+## 安全模型
+
+Codelux 将 Provider 凭据保存在受操作系统文件权限保护的本地文件中。这些文件并未进行
+静态加密，无法防御以同一用户身份运行的进程、特权管理员、恶意软件、账号失陷、备份
+泄露或物理磁盘访问。
+
+跨机器归档使用用户提供的密码加密。除非用户明确要求，否则不会在另一台机器上应用
+活动客户端配置。
+
+漏洞报告方式和详细安全边界见 [SECURITY.zh-CN.md](SECURITY.zh-CN.md)。
+
+## 安装
+
+Codelux 当前处于 Alpha 阶段，尚未发布到正式 Python Package Index。开发环境可从当前
+代码目录安装：
+
+```bash
+python3 -m pip install -e .
+```
+
+## 使用方法
+
+```bash
+codelux version
+codelux status --client claude
+codelux list
+codelux add codelux-io --url https://codelux.io --client claude
+codelux switch codelux-io --client claude
+codelux switch official --client claude
+codelux recover --dry-run
+```
+
+同步命令支持明确选择传输内容：
+
+```bash
+codelux sync export --output codelux-sync.enc --providers --sessions
+codelux sync import codelux-sync.enc
+codelux sync push --ssh user@host.example --providers
+codelux sync pull --ssh user@host.example --providers
+```
+
+可以对任意命令使用 `--help` 查看当前选项和安全提示。
+
+## 开发验证
+
+```bash
+python3 -m pip install . pytest==7.4.4 coverage==7.10.7
+coverage run -m pytest -q
+coverage report
+python scripts/check_public_repository.py
+```
+
+## 许可证
+
+MIT
+

codelux-0.1.0a2/README.md

@@ -0,0 +1,74 @@
+# Codelux
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Codelux is a command-line tool for managing LLM Provider configurations across AI coding
+assistants. It provides explicit Provider switching, recoverable local changes, and encrypted
+cross-machine synchronization.
+
+**Website and Provider API:** [https://codelux.io](https://codelux.io)
+
+## Capabilities
+
+- Provider management for Claude Code and Codex
+- Read-only configuration and health inspection
+- Snapshot-backed restoration of official configurations
+- Fail-closed recovery for incomplete local transactions
+- Encrypted offline export/import and OpenSSH-based synchronization
+- Explicit conflict handling for synchronized configuration and session data
+
+## Security model
+
+Codelux stores Provider credentials in local files protected by operating-system file permissions.
+These files are not encrypted at rest. They are not protected from processes running as the same
+user, privileged administrators, malware, compromised accounts, backups, or physical disk access.
+
+Cross-machine archives are encrypted with a user-provided password. Active client configuration is
+not applied on another machine unless the user explicitly requests it.
+
+See [SECURITY.md](SECURITY.md) for vulnerability reporting and security boundaries.
+
+## Installation
+
+Codelux is currently in alpha and has not been published to the production Python Package Index.
+Install the development checkout with:
+
+```bash
+python3 -m pip install -e .
+```
+
+## Usage
+
+```bash
+codelux version
+codelux status --client claude
+codelux list
+codelux add codelux-io --url https://codelux.io --client claude
+codelux switch codelux-io --client claude
+codelux switch official --client claude
+codelux recover --dry-run
+```
+
+Synchronization commands support explicit content selection:
+
+```bash
+codelux sync export --output codelux-sync.enc --providers --sessions
+codelux sync import codelux-sync.enc
+codelux sync push --ssh user@host.example --providers
+codelux sync pull --ssh user@host.example --providers
+```
+
+Use `--help` on any command to inspect its current options and safety prompts.
+
+## Development
+
+```bash
+python3 -m pip install . pytest==7.4.4 coverage==7.10.7
+coverage run -m pytest -q
+coverage report
+python scripts/check_public_repository.py
+```
+
+## License
+
+MIT

codelux-0.1.0a2/README.zh-CN.md

@@ -0,0 +1,73 @@
+# Codelux
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Codelux 是一个用于在多种 AI 编程助手之间管理大模型 Provider 配置的命令行工具，提供
+明确的 Provider 切换、可恢复的本地修改和加密跨机器同步。
+
+**官网与 Provider API：** [https://codelux.io](https://codelux.io)
+
+## 主要能力
+
+- 管理 Claude Code 和 Codex 的 Provider
+- 只读检查配置与健康状态
+- 通过快照恢复官方配置
+- 对未完成的本地事务执行失败关闭式恢复
+- 加密离线导入导出和基于 OpenSSH 的同步
+- 对同步配置和会话数据执行明确的冲突处理
+
+## 安全模型
+
+Codelux 将 Provider 凭据保存在受操作系统文件权限保护的本地文件中。这些文件并未进行
+静态加密，无法防御以同一用户身份运行的进程、特权管理员、恶意软件、账号失陷、备份
+泄露或物理磁盘访问。
+
+跨机器归档使用用户提供的密码加密。除非用户明确要求，否则不会在另一台机器上应用
+活动客户端配置。
+
+漏洞报告方式和详细安全边界见 [SECURITY.zh-CN.md](SECURITY.zh-CN.md)。
+
+## 安装
+
+Codelux 当前处于 Alpha 阶段，尚未发布到正式 Python Package Index。开发环境可从当前
+代码目录安装：
+
+```bash
+python3 -m pip install -e .
+```
+
+## 使用方法
+
+```bash
+codelux version
+codelux status --client claude
+codelux list
+codelux add codelux-io --url https://codelux.io --client claude
+codelux switch codelux-io --client claude
+codelux switch official --client claude
+codelux recover --dry-run
+```
+
+同步命令支持明确选择传输内容：
+
+```bash
+codelux sync export --output codelux-sync.enc --providers --sessions
+codelux sync import codelux-sync.enc
+codelux sync push --ssh user@host.example --providers
+codelux sync pull --ssh user@host.example --providers
+```
+
+可以对任意命令使用 `--help` 查看当前选项和安全提示。
+
+## 开发验证
+
+```bash
+python3 -m pip install . pytest==7.4.4 coverage==7.10.7
+coverage run -m pytest -q
+coverage report
+python scripts/check_public_repository.py
+```
+
+## 许可证
+
+MIT

codelux-0.1.0a2/pyproject.toml

@@ -0,0 +1,66 @@
+[tool.poetry]
+name = "codelux"
+version = "0.1.0a2"
+description = "Unified Provider management CLI for AI coding assistants"
+authors = ["Codelux AI Initiative"]
+license = "MIT"
+readme = ["README.md", "README.zh-CN.md"]
+homepage = "https://github.com/codelux-io/codelux"
+repository = "https://github.com/codelux-io/codelux"
+keywords = ["ai", "llm", "provider", "claude", "codex"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[tool.poetry.dependencies]
+python = "^3.9"
+click = "^8.1.0"
+cryptography = ">=41,<47"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^7.4.0"
+black = "^23.0.0"
+ruff = "^0.1.0"
+mypy = "^1.7.0"
+coverage = "^7.6.0"
+tomli = { version = "^2.0.0", python = "<3.11" }
+
+[tool.poetry.scripts]
+codelux = "codelux.cli:main"
+
+[build-system]
+requires = ["poetry-core==2.2.1"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.black]
+line-length = 100
+target-version = ["py39"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+
+[tool.coverage.run]
+source = ["src/codelux"]
+
+[tool.coverage.report]
+fail_under = 90
+precision = 2
+show_missing = true

codelux-0.1.0a2/src/codelux/__init__.py

@@ -0,0 +1,12 @@
+"""Codelux - Unified Provider management CLI for AI coding assistants.
+
+Codelux provides a unified interface for managing LLM Provider credentials
+across multiple AI coding assistants (Claude Code, Codex, and future platforms).
+
+The public package contains product behavior only; internal development records are maintained
+outside the distribution repository.
+"""
+
+__version__ = "0.1.0a2"
+__author__ = "Codelux AI Initiative"
+__all__ = ["__version__"]

codelux-0.1.0a2/src/codelux/adapters/__init__.py

@@ -0,0 +1,7 @@
+"""Client adapters."""
+
+from codelux.adapters.base import ClientAdapter
+from codelux.adapters.claude import ClaudeAdapter
+from codelux.adapters.codex import CodexAdapter
+
+__all__ = ["ClientAdapter", "ClaudeAdapter", "CodexAdapter"]

codelux-0.1.0a2/src/codelux/adapters/base.py

@@ -0,0 +1,47 @@
+"""Shared adapter interface."""
+
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import Mapping
+
+from codelux.models import ConfigFile, ObservedConfig, PreparedChange, ProcessState
+
+
+class ClientAdapter(ABC):
+    name: str
+
+    @abstractmethod
+    def is_installed(self) -> bool:
+        """Return whether the client can be addressed on this machine."""
+
+    @abstractmethod
+    def is_running(self) -> ProcessState:
+        """Return a conservative process state."""
+
+    @abstractmethod
+    def inspect(self) -> ObservedConfig:
+        """Read actual client configuration without using registry cache."""
+
+    @abstractmethod
+    def prepare_provider(self, binding: Mapping[str, object]) -> PreparedChange:
+        """Build a change without modifying live files."""
+
+    @abstractmethod
+    def prepare_snapshot_restore(self, manifest: Mapping[str, object]) -> PreparedChange:
+        """Build a full-file restore from a validated snapshot manifest."""
+
+    @abstractmethod
+    def validate_files(self, files: tuple[ConfigFile, ...]) -> None:
+        """Parse and validate candidate files."""
+
+    @abstractmethod
+    def commit(self, change: PreparedChange) -> None:
+        """Commit a prepared change atomically for this client."""
+
+    @abstractmethod
+    def rollback(self, change: PreparedChange) -> None:
+        """Restore the before files; repeated calls must be harmless."""
+
+
+def config_file(path: Path, content: bytes, mode: int = 0o600) -> ConfigFile:
+    return ConfigFile(path=path, content=content, mode=mode & 0o777)