Cherry Studio Development
SkillDocs & knowledgeCherry-electron-dev is a skill for working on the Cherry Studio desktop app. It lets your AI develop, fix, and profile the app inside a running Electron instance, so changes and investigations happen in the real program rather than in the abstract.
Available today. Use it from your connected AI after setup.
No other account needed.
Add the skill and point your AI at the Cherry Studio codebase. It can then open a tracked Electron instance to build, fix, and profile as you work.
Then ask your AI: use the Cherry Studio Development skill
What your AI can do with it
- Implement features and UI interaction work in a running Electron instance
- Fix bugs while testing against the live app
- Debug runtime issues and inspect the app with DevTools
- Investigate lag or jank and monitor CPU and memory usage
- Check for memory leaks and analyze startup performance
- Reuse a verified working setup across sessions
What this skill tells your AI
The instructions your AI receives, as published by cherryhq/cherry-studio in .agents/skills/cherry-electron-dev/SKILL.md and read by ahel’s review.
Use this skill for ongoing work in the current checkout. Do not use it to check
out or report on PRs; use cherry-pr-test for that workflow.
Required runtime workflow
Before reading or controlling Electron UI, read
Electron Instance Management and use its
persistent policy.
That reference is the only authority for instance discovery, instance.json,
CDP target selection, launching, replacement, shutdown, and troubleshooting.
Do not reproduce those procedures here or substitute generic Electron app
control.
Development loop
- State the requested behavior and the evidence that will prove it.
- Read the relevant code and nearby README files.
- Verify and reuse the tracked instance through the runtime reference.
- Reproduce or inspect the current behavior before editing when practical.
- Capture the smallest useful evidence: UI state, DOM, console/network output, main-process logs, persisted state, or performance metrics.
- Trace the responsible code path and make only the requested change.
- Keep Electron running. Use HMR for renderer changes and verify in the same window.
- Repeat the same scenario and compare before/after evidence.
Inspect the real window at the relevant size and theme for UI work. Check both renderer and main-process evidence for renderer failures.
Restart only for a non-reloadable layer, crash, unreliable runtime state, or
startup profiling. Use the reference's exact-instance replacement procedure,
refresh instance.json, and keep the replacement running.
Run the narrowest relevant validation and follow current user and repository instructions for lint, formatting, and tests.
Performance and DevTools
For lag, jank, high CPU, memory growth, leaks, slow startup, or explicit DevTools use, read Performance Debugging.
Store temporary logs, screenshots, and profiles under
.context/cherry-electron-dev/. Compare a quiet baseline with the same bounded
scenario before and after a fix. Detach profiling sessions afterward; do not
close the CDP browser, page, or Electron process.
Handoff
Leave reused user-owned and healthy agent-launched instances running after the instruction. Stop one only when the user asks, a required restart is part of the task, or the instance is unhealthy and blocks progress.
Report the verified PID, whether it remains running, CDP port, tracking file, evidence paths, reproduction, and verification.
Signals
- GitHub stars
- 52k
- Forks
- 5k
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
cherry-electron-dev- Source
- github.com/cherryhq/cherry-studio