Repository navigation
cmux-sidebar: nested workspace groups and live agent dots, as a custom sidebar #35366
s4ff0x
started this conversation in
Show and tell
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
cmux groups are flat, and with 80+ workspaces I kept losing track of which agent was still working and which one had finished while I was somewhere else. So I built a custom sidebar on the JS sidebar runtime that fixes both for me.
The GIF is a real cmux window with demo workspaces and scripted agent events.
What it does
Work/Backend/APIand it shows as a tree. Rename, re-nest and drag whole subtrees.API ›.Install (from a cmux terminal, cmux 0.64.25 or newer):
curl -fsSL https://github.com/s4ff0x/cmux-sidebar/releases/latest/download/install.sh | shIt downloads one file into
~/.config/cmux/sidebars/, runscmux sidebar validate, and selects it. If validation fails, it puts the previous file back.Tested with Claude Code and omp. It reads cmux's generic agent status, so other agents with cmux hooks should work too.
It stays cheap with many workspaces: an unchanged tick sends no scene updates, and rows mount only the icons they show, which cut the main thread from about 85% to about 52% busy while scrolling 102 workspaces.
It's a beta and a fork of
Examples/CustomSidebars/workspaces.js, so it keeps rename, the unread badge, multi-select and drag-and-drop. GPL-3.0.Repo: https://github.com/s4ff0x/cmux-sidebar
Feedback and bug reports are welcome, especially from people on other agents. Thanks to the cmux team for the sidebar runtime, it made this easy to build.
All reactions