Metadata-Version: 2.4
Name: zrcoder
Version: 0.3.0
Summary: Terminal coding agent chat — OpenAI-compatible APIs, tools, and slash commands
Keywords: cli,agent,coding,terminal,openai
Author: Zr
Author-email: Zr <547471919@qq.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Requires-Dist: prompt-toolkit>=3.0.53
Requires-Dist: pydantic-ai>=2.40.0
Requires-Dist: python-dotenv>=1.2.3
Requires-Dist: questionary>=2.1.1
Requires-Dist: rich>=15.0.0
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/ZRMYDYCG/ClaudeCode
Project-URL: Repository, https://github.com/ZRMYDYCG/ClaudeCode
Project-URL: Issues, https://github.com/ZRMYDYCG/ClaudeCode/issues
Project-URL: Changelog, https://github.com/ZRMYDYCG/ClaudeCode/blob/main/CHANGELOG.md
Description-Content-Type: text/markdown

# Zrcoder

<p align="center">
  <img src="docs/zrcoder-banner.jpg" alt="Zrcoder — AI Terminal CLI" width="100%">
</p>

终端里的编程助手：连 OpenAI 兼容 API，可读写文件、执行命令，并支持斜杠命令与会话恢复。

## 安装

需要 Python **3.12+**。推荐用 [uv](https://docs.astral.sh/uv/)：

```bash
uv tool install zrcoder
```

也可用 pipx / pip：

```bash
pipx install zrcoder
# 或
pip install zrcoder
```

## 配置

设置环境变量，或在以下位置之一创建 `.env`（可参考 `.env.example`）：

- 当前目录：`./.env`
- 用户配置：`~/.config/zrcoder/.env`
- 兼容路径：`~/.zrcoder.env`

```bash
export API_KEY=your_api_key
export BASE_URL=https://api.example.com/v1
# 可选，默认 deepseek-v4-flash
# export MODEL_NAME=deepseek-v4-flash
```

## 使用

```bash
zrcoder
```

常用命令：`/help`、`/status`、`/new`、`/resume`、`/api-detail`、`/exit`。

## 变更与发版

- 用户可见变更：[CHANGELOG.md](CHANGELOG.md)
- 维护者发版流程：[RELEASING.md](RELEASING.md)

## 从源码开发

```bash
git clone https://github.com/ZRMYDYCG/ClaudeCode.git
cd ClaudeCode
uv sync --group dev

uv run zrcoder
# 或
uv run python main.py

uv run ruff format .
uv run ruff check --fix .
uv run pytest
uv run mypy core
```

## License

MIT
