Metadata-Version: 2.4
Name: comate-cli
Version: 0.12.5
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.14,>=3.11
Requires-Dist: charset-normalizer==3.4.7
Requires-Dist: comate-agent-sdk<0.13,>=0.12.21
Requires-Dist: comate-rpc<0.2,>=0.1.4
Requires-Dist: concurrent-log-handler>=0.9.25
Requires-Dist: curl-cffi==0.13.0
Requires-Dist: httpx<0.29.0,>=0.28.1
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
Requires-Dist: setproctitle>=1.3.7
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
```

## 内置 Marketplace 扩展

发行版可通过 `DistributionProfile.builtin_marketplaces` 提供
`BuiltinMarketplace(name=展示名称, source=HTTP清单地址)`。
默认值为空；Comate 不预置任何源。

用户打开 `/plugin` 后，Discover 直接加载内置清单并展示插件。浏览不会注册源；
确认插件安装后，程序保存来源信息，复用已有的安装和更新流程。
内置源在 Marketplaces 中始终可见，不提供删除、隐藏或禁用操作。
清单请求失败时可在 Discover 选择重试，其他来源仍可浏览。

当前内置清单支持 HTTP/HTTPS manifest URL。Git 源仍可通过原有手动添加流程使用。

## MCP

`comate mcp` supports Claude Code compatible MCP configuration commands for common add/list/get/remove flows.

```bash
comate mcp add firecrawl npx -y firecrawl-mcp
comate mcp add -t http sentry https://mcp.sentry.dev/mcp -H "Authorization: Bearer ..."
comate mcp add-json ctx '{"type":"http","url":"https://example.test/mcp"}'
```

Supported scopes are `local` (default), `project`, and `user`. Comate stores MCP configuration under `.agent` / `~/.agent`; it does not read or modify Claude Code configuration files.

## 排错 / 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。

## Author

andy

by andy
