connect-chatcut-desktop
GitHub提供 ChatCut Desktop 的官方下载链接及安装、修复指南,处理 MCP 工具缺失问题。指导用户完成跨平台部署并处理签名权限异常,若无法自动解决则引导手动操作。
Trigger Scenarios
Install
npx skills add ChatCut-Inc/agent-plugin --skill connect-chatcut-desktop -g -y
SKILL.md
Frontmatter
{
"name": "connect-chatcut-desktop",
"description": "Install, open, connect, or repair ChatCut Desktop when the chatcut_desktop MCP tools are missing or unavailable. Do not use from a managed agent already running inside ChatCut Desktop, or when chatcut_desktop tools are already available."
}
Connect ChatCut Desktop
Use the signed production Desktop app as the only source of the local MCP server and editing skills. This plugin contains instructions only, not an installer or MCP configuration.
If chatcut_desktop tools are already available, call get_active_project and
continue with the user's editing request. Do not reinstall the app or change MCP
configuration. If the current host is ChatCut Desktop's managed Codex agent,
stop; its project-pinned MCP and built-in skills are already authoritative.
Download
Use only the matching official URL:
- macOS Apple Silicon:
https://api.chatcut.io/desktop/download/macos - macOS Intel:
https://api.chatcut.io/desktop/download/macos-x64 - Windows x64:
https://api.chatcut.io/desktop/download/windows
ChatCut Desktop supports macOS 13 or newer on Apple Silicon or Intel and Windows
on x64. Linux is unsupported. Do not substitute a search result, third-party
mirror, hosted ChatCut MCP, or historical chatcut@chatcut-inc plugin.
Install or repair
Try to complete the ordinary platform installation for the user with the host's narrow command approval:
- Detect the operating system and architecture and choose the URL above.
- Download the official artifact to a temporary directory. If ChatCut is already installed but will not open, inspect it before replacing it.
- On macOS, use native tools to mount a DMG or extract a ZIP, then copy
ChatCut.appto/Applicationsor the user'sApplicationsdirectory. On Windows, open the downloaded installer and let the visible installer finish. - Open ChatCut Desktop. It registers
chatcut_desktopand synchronizes its editing skills into Codex automatically.
Installing outside the project sandbox or opening an installer may require host approval. Request only the scoped operation needed for that step; never ask the user to enable persistent Full access.
For macOS launch or code-signing failures, inspect codesign, Gatekeeper,
permissions, and quarantine state. Try remounting or re-extracting a fresh
official download, fixing destination permissions, or clearing stale quarantine
only after the official app's signature validates. Never modify or ad-hoc sign
the app, disable Gatekeeper, or bypass an invalid signature. On Windows, do not
bypass an invalid or unknown Authenticode publisher warning.
Retry one fresh official download if the artifact is incomplete, corrupt, for the wrong architecture, or fails a normal copy or extraction step. Do not loop.
User handoff
If the host cannot download, mount, extract, copy, approve, repair, or run the installer, stop trying. Tell the user what blocked automation and give them the exact matching official URL above so they can install and open ChatCut with the visible operating-system flow.
After ChatCut opens, ask the user to sign in there if needed. Do not handle their
credentials or add chatcut_desktop to config.toml manually. Because Codex
loads MCP tools and skills when a task starts, tell the user to start a new task
after Desktop finishes connecting.
Version History
- 014586d Current 2026-08-27 10:42


