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

