cmux-custom-sidebar — Claude Code skill: build a custom sidebar
Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap.
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a claude-codeWhat cmux-custom-sidebar does
cmux interprets a sidebar from a SwiftUI-style file at runtime, no build or signing needed. The skill translates a plain-language request into a working file in ~/.config/cmux/sidebars/. The sidebar binds to live cmux state: workspace list, tabs, git branches, PRs, and time.
The workflow is straightforward: enable the beta flag in settings, create a file in the sidebars folder, validate it with cmux sidebar validate <name>, select it from the menu, and save. Each save triggers a hot reload. Buttons in the sidebar can run any cmux command — switch workspaces, open tabs, change status.
The skill handles SwiftUI component selection, syntax validation, and state binding. You don't need to know the language, data structures, or available commands. Describe what elements belong on the sidebar and what they should do.
What it helps with
- display workspaces and tabs on a sidebar with quick-switch buttons
- bind sidebar elements to live cmux state and PR information
- add interactive buttons that run workspace or PR commands
- implement drag-and-drop reordering for workspace lists
- iterate sidebar design with instant hot reload on file save
Example prompts for the agent
- Write a skill to build a sidebar that shows my workspaces on the left with status icons and lets me select them
- Create a sidebar with a clock at the top, a list of workspaces, and buttons to switch between them
- Build a sidebar that displays open PRs in each workspace and makes them clickable to open
How to install cmux-custom-sidebar
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a claude-code2Manually: put the files in place
~/.claude/skills/cmux-custom-sidebar/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cmux-custom-sidebar/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a codex2Manually: put the files in place
.agents/skills/cmux-custom-sidebar/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a cursor2Manually: put the files in place
.cursor/skills/cmux-custom-sidebar/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-custom-sidebar2Manually: put the files in place
.github/skills/cmux-custom-sidebar/SKILL.md1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a gemini-cli2Platform CLI
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-custom-sidebarManually: put the files in place
.devin/skills/cmux-custom-sidebar/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set12
The whole set →Similar
Questions about cmux-custom-sidebar
How do I install cmux-custom-sidebar for Claude Code?
Run npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a claude-code twice. The skill will be available in Claude Code.
What does cmux-custom-sidebar do?
The skill helps you write a custom sidebar for cmux. You describe the result in plain language, the skill generates a SwiftUI-style code file, saves it to ~/.config/cmux/sidebars/, validates it, and connects it to cmux.
What data can a sidebar display?
A sidebar can bind to workspaces, tabs, status, git branches, PRs, time, and ports. Tapping sidebar elements can run cmux commands such as switching workspaces or opening a PR.