Metadata-Version: 2.4
Name: comate-cli
Version: 0.7.0a6
Summary: Comate terminal CLI built on comate-agent-sdk
Project-URL: Homepage, https://github.com/AndyLee1024/agent-sdk
Project-URL: Repository, https://github.com/AndyLee1024/agent-sdk
Author-email: Andy <andy.dev@aliyun.com>
Keywords: agent,cli,comate,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: charset-normalizer==3.4.7
Requires-Dist: comate-agent-sdk<0.9.0,>=0.8.0a1
Requires-Dist: concurrent-log-handler>=0.9.25
Requires-Dist: curl-cffi==0.13.0
Requires-Dist: packaging>=21.0
Requires-Dist: pillow==12.2.0
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: requests==2.32.5
Requires-Dist: rich>=14.0
Description-Content-Type: text/markdown

# comate-cli

Comate terminal CLI package.

## Usage

```bash
uvx comate-cli
```

Or install globally:

```bash
uv tool install comate-cli
comate
```

## 排错 / Troubleshooting

### 看不到错误信息但行为异常

comate 在生产模式下会把若干无害但吵闹的 shutdown 噪音写入
`~/.comate/logs/agent.log`，而不是显示在终端里。这包括 Windows asyncio
shutdown 的 `ResourceWarning`、MCP 服务器违规向 stdout 写日志导致的 JSONRPC
解析失败，以及解释器退出阶段的 unraisable 异常。

如果你怀疑隐藏了真实错误，可以按下面顺序排查：

```bash
# 1. 看 noise 通道的最近 50 条
grep -E "\[unraisable\]|\[excepthook\]|\[warning\]" ~/.comate/logs/agent.log | tail -50

# 2. 看完整 agent.log 末尾
tail -200 ~/.comate/logs/agent.log

# 3. 临时关掉噪音接管器,看原始输出(开发场景)
COMATE_DEBUG_NOISE=1 comate
```

`COMATE_DEBUG_NOISE=1` 设置后，`_ShutdownNoiseGuard` 会跳过 install，
错误会像旧版本一样直接打印到 stderr。
