Overview
cherry-tool-guide is an open-source frontend skill for Claude Code and compatible agents, published by CherryHQ. Its author describes it as: “Cherry Studio first-party tool and bundled-shell routing for general agents. For straightforward local work in shell-capable sessions, run JS/TS with `bun <file>` and one-off JS tools with `bun x`; run Python with `uv…”. The project has 52k stars on GitHub and is available under the AGPL-3.0-only license. Add it to your setup with `git clone https://github.com/CherryHQ/cherry-studio ~/.claude/skills/cherry-tool-guide`.
What cherry-tool-guide does
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.
Best for
What’s inside
The SKILL.md for cherry-tool-guide is organised into these sections:
- Global rules
- Routing table
- When a tool isn't there
- Out of scope
Installation
Add cherry-tool-guide to your agent with:
git clone https://github.com/CherryHQ/cherry-studio ~/.claude/skills/cherry-tool-guideReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — declared in the repository topics
- Codex — declared in the repository topics
License
cherry-tool-guide is published under the AGPL-3.0-only license.
Strengths
- Clear AGPL-3.0-only license — safe to read and adapt within its terms
- Ships in CherryHQ/cherry-studio, an established project with 52,047 GitHub stars
- Works with Claude Code, Codex
- Actively maintained — repository updated in the last 30 days
- Its repository gained 2,662 GitHub stars over the last 48 days
Author
Topics
Frequently asked questions
- What does cherry-tool-guide do?
- Cherry Studio first-party tool and bundled-shell routing for general agents. For straightforward local work in shell-capable sessions, run JS/TS with `bun <file>` and one-off JS tools with `bun x`; run Python with `uv run [--with <pkg>] python` and one-off Python CLIs with `uvx`; search with `rg`. Load this guide before changing project dependencies, deciding whether a tool should be ephemeral or reusable, reading or converting local Office/PDF files, coordinating or delegating across Agent Sessions, or using Cherry-owned web/browser, knowledge, persistent memory, schedules/notifications, IM channels, image generation, artifact reporting, managed CLI, skill, or MCP-server-registration capabilities—even if the user names no tool. Consult it before shell/file workarounds; live tool schemas are authoritative.
- How do I install cherry-tool-guide?
- Run git clone https://github.com/CherryHQ/cherry-studio ~/.claude/skills/cherry-tool-guide in your agent, then reload your skills. Review the source at https://github.com/CherryHQ/cherry-studio before installing.
- Is cherry-tool-guide free to use?
- Yes. cherry-tool-guide is free and open source under the AGPL-3.0-only license, so you can read, run, and adapt it within that license's terms.
- Which agents does cherry-tool-guide work with?
- cherry-tool-guide lists Claude Code and Codex — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does cherry-tool-guide come from?
- cherry-tool-guide ships inside CherryHQ/cherry-studio, a repository that contains 37 catalogued skills in total. The repository's 52,047 GitHub stars apply to that whole collection, not to this skill on its own.