# mewcode

**Repository Path**: lixiaobin1304/mewcode

## Basic Information

- **Project Name**: mewcode
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MewCode-Lite

> 教学版简易 Claude Code 内核 —— ~1k 行代码,5 分钟跑通。
>
> **当前版本:v0.1.0** · 58 测试通过 · 71% 覆盖率 · MIT License

**这是 [mewcode/](./mewcode/) 完整参考实现的教学精简版**,只保留核心循环,剥离所有高级特性,
让学员能在 1-2 小时内读完代码,理解"一个 prompt 如何变成一次 tool call 再写回文件"。

## 5 分钟快速开始

```bash
# 安装
cd /d/module/damoxing/mewcode-python
uv sync --extra dev

# 设置 API key
export ANTHROPIC_API_KEY=sk-ant-...

# 非交互模式:让 LLM 完成一个任务
uv run python -m mewcode_lite -p "在当前目录写一个 hello.py" --yes

# 交互模式
uv run python -m mewcode_lite
```

## 核心架构

4 个核心文件,~1k 行代码:

- **`mewcode_lite/__main__.py`** —— 启动入口,解析参数,组装各组件
- **`mewcode_lite/agent.py`** —— tool loop 核心,async generator 产出事件流
- **`mewcode_lite/backend/anthropic.py`** —— Anthropic API 调用
- **`mewcode_lite/tools/*.py`** —— 5 个内置工具(Bash/Read/Write/Edit/Grep)

详见 [docs/architecture.md](docs/architecture.md)。

## 教程

- **[tutorial.md](docs/tutorial.md)** —— 从 main() 跟到一个 tool call,手把手 walkthrough
- **[how-to-add-a-tool.md](docs/how-to-add-a-tool.md)** —— 自定义工具分步教程
- **[how-to-add-a-backend.md](docs/how-to-add-a-backend.md)** —— 自定义后端分步教程

## 示例

`examples/` 目录:

- `tools/weather_tool.py` —— 自定义工具(查天气,假数据)
- `backends/echo_backend.py` —— 自定义后端(回显,不调用 LLM)

## 与完整版 mewcode 的差异

| 特性 | mewcode-lite | mewcode(完整版) |
|---|---|---|
| 代码量 | ~2.5k 行 | ~14.5k 行 |
| 后端 | Anthropic only | Anthropic / OpenAI / 兼容层 |
| 工具 | 5 个核心 | 27 个(包括子 Agent、skill 加载等) |
| 权限 | 极简 Y/N | 5 层决策链 + 规则引擎 + 沙盒 |
| 上下文 | 不压缩 | 2 层压缩 + memory + recall |
| Hook | 无 | 完整事件系统 |
| MCP | 无 | 完整协议支持 |
| Skill | 无 | markdown 加载 + 热重载 |
| Worktree | 无 | git worktree 管理 |
| Teams | 无 | 多 Agent 协作 |
| TUI | 极简(Textual) | 完整(自动补全、折叠、弹窗) |

简言之:lite 砍掉了所有高级特性,只留核心循环。想深入研究,请读 `mewcode/` 完整参考实现。

详见 [docs/comparison.md](docs/comparison.md) 和 [docs/further-reading.md](docs/further-reading.md)。

## 开发

```bash
# 跑测试
uv run pytest

# 跑 coverage
uv run pytest --cov=mewcode_lite

# 类型检查
uv run mypy mewcode_lite

# lint
uv run ruff check .

# 跑 live 测试(需要 ANTHROPIC_API_KEY)
ANTHROPIC_API_KEY=sk-ant-... uv run pytest -m live tests/e2e/
```

## License

本项目采用 **MIT License** 开源 —— 详见 [LICENSE](LICENSE) 文件。

教学项目,派生自 Claude Code 的公开行为。代码本身可自由使用、修改、分发。
Anthropic、Claude 及相关商标归 Anthropic, PBC 所有。