# Cherry Tool Guide

Cherry tool routing: bun, uv, rg, knowledge, memory, schedules, skills, MCP, web.

- Repository: https://github.com/CherryHQ/cherry-studio (53164 stars)
- Category: AI and agents
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add CherryHQ/cherry-studio --skill cherry-tool-guide -g -a claude-code -y`
Codex: `npx skills add CherryHQ/cherry-studio --skill cherry-tool-guide -g -a codex -y`
Cursor: `npx skills add CherryHQ/cherry-studio --skill cherry-tool-guide -g -a cursor -y`
Gemini CLI: `npx skills add CherryHQ/cherry-studio --skill cherry-tool-guide -g -a gemini-cli -y`

## Description

Cherry tool routing: bun, uv, rg, knowledge, memory, schedules, skills, MCP, web. Read before shell workarounds.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Cherry Tool Guide

Cherry Studio injects first-party tools into your session over four MCP servers
(`mcp__cherry-tools__*`, `mcp__agent-memory__*`, `mcp__skills__*`, `mcp__mcp-manager__*`)
and gives shell-capable general agents bundled runtimes for local execution. The MCP
tools act on the running app, the user's knowledge bases, IM channels, schedules,
managed CLIs, skill library, and MCP server registry, through boundaries only Cherry
owns. Shell and file tools cannot reach those app boundaries correctly; use the bundled
runtimes only for the local execution cases routed below.

**This file is a router.** It carries only the global rules and the intent → tool →
reference table. Each reference holds that domain's prerequisites, sequencing,
conditional availability, output interpretation, recovery, and examples. Read the one
reference the task needs (and any it cross-links to) before calling, don't work from
this page alone.

Tool names here are fully qualified (`mcp__server__tool`); the exact names exposed in
your session are authoritative if they ever differ. This guide never restates argument
shapes, **the live tool schema in your session is the authoritative source** for
parameter names, enums, and required fields. Read it before every call.

## Global rules

The rest: https://github.com/CherryHQ/cherry-studio/blob/HEAD/resources/skills/cherry-tool-guide/SKILL.md