comate-cli

Comate terminal CLI package.

Usage

uvx comate-cli

Or install globally:

uv tool install comate-cli
comate

简体中文用户

Python 解释器从 npmmirror 下载，包从清华 PyPI 镜像下载，运行时固定为 Python 3.12（ADR 0055）。

macOS / Linux（bash、zsh）：

UV_PYTHON_INSTALL_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone \
  uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple

Windows PowerShell（两行在同一个窗口里运行）：

$env:UV_PYTHON_INSTALL_MIRROR="https://registry.npmmirror.com/-/binary/python-build-standalone"
uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple

Windows CMD（两行在同一个窗口里运行）：

set "UV_PYTHON_INSTALL_MIRROR=https://registry.npmmirror.com/-/binary/python-build-standalone"
uv tool install comate-cli --python 3.12 --default-index https://pypi.tuna.tsinghua.edu.cn/simple

清华镜像同步 PyPI 有延迟。新版本刚发布时，如果清华上还没有，去掉 --default-index ... 直接从官方 PyPI 安装即可，Python 仍走 npmmirror。

内置 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.

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 异常。

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

# 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