cmux-custom-sidebar

cmux-custom-sidebar is a skill for Claude Code, Codex from disler/learning-cmux-with-agents. It costs 85 tokens per session (1,689 once invoked), scanned A, original, MIT.

A way to create custom sidebars in cmux, a terminal app for working with coding agents. You describe what the sidebar should show, and it creates the needed sidebar file.

In plain words
What is it for?
Use it to make sidebars showing workspaces, tabs, Git information, pull requests, or a clock, with actions such as switching between workspaces.
Why use it?
It removes the need to learn the sidebar file format or build a macOS app. It turns a desired workspace view into a sidebar that can update as cmux state changes.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to make sidebars showing workspaces, tabs, Git information, pull requests, or a clock, with actions such as switching between workspaces.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/disler/learning-cmux-with-agents/cmux-custom-sidebar
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add disler/learning-cmux-with-agents --skill cmux-custom-sidebar
Clone the repo
git clone --depth 1 https://github.com/disler/learning-cmux-with-agents

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cmux-custom-sidebar

README.md
[![agentmods](https://agentmods.dev/badge/skills/disler/learning-cmux-with-agents/cmux-custom-sidebar/github.svg)](https://agentmods.dev/skills/disler/learning-cmux-with-agents/cmux-custom-sidebar)
Your own site
<a href="https://agentmods.dev/skills/disler/learning-cmux-with-agents/cmux-custom-sidebar"><img src="https://agentmods.dev/badge/skills/disler/learning-cmux-with-agents/cmux-custom-sidebar/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cmux-custom-sidebar

Your own site · 80×15
<a href="https://agentmods.dev/skills/disler/learning-cmux-with-agents/cmux-custom-sidebar"><img src="https://agentmods.dev/badge/skills/disler/learning-cmux-with-agents/cmux-custom-sidebar.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,689 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Rogue Agent · line 24
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00085 $0.01689
Opus 5 $0.00043 $0.00844
Sonnet 5 $0.00017 $0.00338
Haiku 4.5 $0.00009 $0.00169

Measured 13d ago against content hash 708dea7dace8, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

cmux-custom-sidebar scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/docs/custom-sidebars.md
ai_docs/cmux-skills/cmux-custom-sidebar/SKILL.md · 93 lines

How it starts

The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.

cmux Custom Sidebar

cmux renders custom sidebars from a small SwiftUI-style file at runtime: no Xcode, no build step, no signing. The file hot-reloads on save, binds to live cmux state (workspaces, tabs, git, PRs, clock), and can run real cmux commands on tap.

The person asking is usually describing a result ("a sidebar that shows my workspaces and lets me jump between them"), not an implementation. Turn that into a clean, native-looking sidebar and make the engineering decisions for them. Do not ask them about SwiftUI, files, or syntax.

Full reference

This skill is the workflow summary. The complete authoring contract (every supported view, modifier, language feature, and data field) is one command away; read it before writing a non-trivial sidebar:

cmux docs sidebars
curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/docs/custom-sidebars.md

Workflow

  1. Enable the beta (once). Custom sidebars are behind Settings → Beta features → Custom sidebars (customSidebars.beta.enabled). If a written sidebar does not appear in the picker, this flag is the first thing to check.
  2. Write a named file. The name becomes the menu label; use short kebab-case:
    ~/.config/cmux/sidebars/<name>.swift
    
    The file is a single SwiftUI-style view expression (no struct, no var body, no imports). A .json variant exists for static layouts; prefer .swift for anything dynamic.
  3. Validate and select it:
    cmux sidebar validate <name>   # parse/interpret check with real data shapes
    cmux sidebar select <name>     # switch the sidebar to it
    
    The user can also pick it manually: right-click the sidebar toggle button.
  4. Iterate. Saving the file hot-reloads the sidebar in place (cmux sidebar reload forces it). Look at the result, fix what looks off, and verify rows show real data and taps do the right thing before declaring it done.

Authoring rules

  • Default to live data. Bind to the workspaces context instead of hard-coding text so the sidebar stays correct on its own.
  • Make it interactive by default. Rows that represent something openable should run the matching cmux(...) action on tap. A list that just displays text is rarely what they wanted.
  • Prefer Reorderable for workspace-like lists. It gives persisted drag-and-drop reordering for free.
  • Keep it native and uncluttered: a title, a divider, then the content.
  • Cap long lists (.prefix(20), filter/sort before rendering). The sidebar re-evaluates about once a second; do not render hundreds of rows.
  • Stay inside the supported subset. Unsupported syntax is skipped gracefully (never crashes), but choose the closest supported approach rather than shipping a half-blank sidebar.

Read the full file on GitHub · 93 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 13d ago First seen · 93 lines · 85 tokens per session scan A 708dea7dace8

Subscribe to this mod's changes

cmux-custom-sidebar is a skill published in the GitHub repository disler/learning-cmux-with-agents (110 stars, last pushed 2mo ago), licensed MIT. It adds 85 tokens to every session and 1,689 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

webgl-holographic-foil

A self-contained WebGL2 hero: thin-film interference over a crushed-foil surface whose palette shifts with the viewing angle; move the cursor to tilt the film.

nexu-io/open-design · 41 tokens

html-ppt-hermes-cyber-terminal

OpenDesign + BYOK: choosing and wiring your own model, hands-on — cost, quality, and the routing decision. Built as a decision-grade AI literacy deck for engineers, IT, applied-AI teams.

nexu-io/open-design · 53 tokens

html-ppt-taste-brutalist

16:9 HTML deck in tactical-telemetry / CRT-terminal taste. Deactivated-CRT charcoal slides, white-phosphor monospace, hazard-red accent, scanline overlay, ASCII syntax, density over decoration. Distilled from Leonxlnx/taste-skill brutalist-skill (Tactical Telemetry mode).

nexu-io/open-design · 78 tokens

visual-ralph

Visual Ralph orchestration for frontend UI from generated references, static references, or live URL targets, using $ultragoal with built-in visual verdict and pixel-diff evidence until the implementation matches and leaves a reproducible design system.

Yeachan-Heo/oh-my-codex · 52 tokens

accessibility

Consolidated accessibility skill entrypoint for WCAG 2.2, ARIA Authoring Practices, cognitive accessibility, Section 508, EN 301 549, design intent verification, and the Accessibility Planner workflow.

microsoft/hve-core · 47 tokens

make-resume

A Chinese-language tool for creating editable HTML resumes that can be changed in a browser and printed to PDF. It uses available resume templates when they are installed and otherwise provides a simpler fallback.

Hisn00w/ASu-skills · 86 tokens