# acp_client

**Repository Path**: fatgrass/acp_client

## Basic Information

- **Project Name**: acp_client
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-11
- **Last Updated**: 2025-11-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ACP 客户端

通用 ACP (Agent Client Protocol) 客户端，支持与任意 ACP 兼容 CLI 工具通信，具备流式输出和完整权限管理。

## 快速开始

```bash
# 安装
pip install -e .

# 运行示例 (推荐)
CLAUDE_PERMISSION_MODE=bypassPermissions python examples/basic_client.py
```

## 基本用法

```python
import asyncio
from acp_client import ACPClient

async def main():
    client = ACPClient()
    await client.connect("claude-code-acp")  # 默认
    response = await client.send_command("你好")
    print(response)
    await client.disconnect()

asyncio.run(main())
```

## 连接方式

- **按名称**: `await client.connect("kimi-cli")`
- **按命令**: `await client.connect(["node", "dist/index.js"])`
- **自定义**: 使用 `CLICommand` 类配置

## 核心特性

- ✅ **流式输出**: 实时显示 AI 响应
- ✅ **权限管理**: 支持文件操作权限控制
- ✅ **命令广播**: 自动获取可用工具命令
- ✅ **多 CLI 支持**: Claude Code ACP, Kimi CLI 等

## 权限配置

Claude Code ACP 需要权限跳过才能执行文件操作：

```bash
export CLAUDE_PERMISSION_MODE=bypassPermissions
python examples/basic_client.py
```

## 可用工具命令

```python
await client.send_command("compact")  # 清空对话
await client.send_command("xlsx")     # 电子表格
await client.send_command("init")     # 初始化项目
```

## 开发

```bash
pip install -e ".[dev]"
pytest  # 运行测试
ruff format .  # 代码格式化
```

## 已验证 CLI

- ✅ **Claude Code ACP**: 完全支持 (默认)
- ✅ **Kimi CLI**: 基础功能支持
- 🔧 **Claude CLI**: 需要权限参数

更多详情请查看 `examples/` 目录中的示例代码。