Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manaflow-ai/cmux --skill cmux-custom-sidebar -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/cmux-custom-sidebar/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-custom-sidebar/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs cmux-ghostty manaflow-ai Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. Claude Code CX Codex Cursor +1 4,700installs

Similar

receipts official Anthropic Generates a personal Claude Code activity report from local session transcripts — for justifying spend to a manager or self-review. Claude Code 2,052installs digest official anthropics Builds a daily or weekly digest from connected sources, covering mentions, action items, decisions, and document changes. Useful when you need to catch up on project activity. Claude Code CX Codex Cursor +1 2,700installs seo-cluster AgriciDaniel Clusters keywords by SERP overlap and designs hub-and-spoke content architecture with internal links. Use it before writing posts to avoid cannibalization. Claude Code CX Codex Cursor +1 6,700installs just casey Reference skill for just, a command runner that executes tasks from a justfile. Use when your project has a justfile or you need syntax help for recipes and commands. Claude Code CX Codex Cursor +1 1,000installs argent-react-native-app-workflow software-mansion Provides step-by-step procedures for building, running, and debugging React Native apps on iOS simulators or Android emulators. Helps resolve Metro issues and build crashes. Claude Code CX Codex Cursor +1 26,300installs argent-metro-debugger software-mansion A skill that connects a debugger to a JS runtime via CDP. Inspect React components, read console logs, and evaluate code live. Works with React Native (iOS, Android, Vega) and Chromium apps (Electron, browsers). Claude Code CX Codex Cursor +1 26,200installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs

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.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor