从别的工具过来

这讲的是这台机器上的文件和会话。

会自动拾取的

不必手抄这些。matcha inspect 会显示落了什么、来自哪家。

规则与说明

• AGENTS.md（以及 Agents.md、AGENT.md）
• CLAUDE.md、Claude.md、CLAUDE.local.md
• .matcha/rules/、.claude/rules/、.cursor/rules/ 下的 *.md
• ~/.matcha/rules/、~/.claude/rules/、~/.cursor/rules/ 下的主目录副本

说明冲突时，更深的文件胜出。.gitignore 会跳过被忽略的规则 **文件**；技能根目录不使用 gitignore。

技能与自定义命令

• ~/.claude/skills/、~/.claude/commands/
• ~/.cursor/skills/
• 项目侧对应目录（.claude/、.cursor/、.matcha/、.agents/）
• 扁平的命令 .md 会变成斜杠命令

MCP 服务

• ~/.claude.json
• .cursor/mcp.json（用户与项目）
• 项目 .mcp.json

钩子

• .claude/settings.json（以及 settings.local.json）
• .cursor/hooks.json
• Bash 这类 matcher 别名仍会触发

在 ~/.matcha/config.toml 里关掉某家兼容面：

[compat.claude]
mcps = true
skills = true
hooks = true
rules = true

[compat.cursor]
mcps = true
skills = true
hooks = true
rules = true

环境变量对应项：MATCHA_CLAUDE_MCPS_ENABLED、MATCHA_CURSOR_SKILLS_ENABLED，以及配置文档里其他 MATCHA_*_*_ENABLED 项。

一步导入 Claude：`/import-claude`

/import-claude

无参数（多余文字会被忽略）。命令打开复选框预览，列出 ~/.claude / .claude 里可导入的项 — 权限、环境变量、MCP 服务、钩子和路径。

确认后把所选项目写入你的 .matcha 配置。随时可再跑。空扫描显示 “No Claude settings found to import.” 关掉欢迎提示会记录你选择退出对该内容的静默 .claude 回退。

继续别人的会话

随附技能（本地技能会加载时）提供：

/resume-claude
/resume-codex
/resume-cursor

用它们在 **本次 Matcha CLI 会话** 里继续该工具最近的会话。它们是技能，不是那些产品的云同步。

检查发现了什么

matcha inspect
matcha inspect --json

预期看到规则文件（路径 + token 估算）、带来源标签的技能，以及来自兼容路径时标了 [claude] 或 [cursor] 的 MCP 服务。

不要做这些

• 不要把旧的 xAI / Grok 凭证当成 MatchaCode 账号。若要用该服务商，只把它当作 **xAI 服务商** 密钥导入。
• 不要用 /marketplace 安装你在别的产品里用过的东西。改为安装本地插件文件夹。
• 不要指望 /flush 或 /dream 复现别的工具的记忆管线。用 /remember 和本地存储。

你可能漏看的：/btw 问旁支问题而不打断当前任务；/rewind 把对话回滚（文件改动仍在磁盘上）。

你应该看到