paseo-plugin-clusters

English · Español

A Paseo plugin that groups your projects into clusters and puts them as circles above the workspace list, Discord-style.

Installation

paseo plugin install github:thisjrodriguez/paseo-plugin-clusters

What it does

• Circles in the sidebar. A row above "New workspace". Selecting a cluster filters the native list down to its projects.
• Recents. Projects used recently (24 hours by default, adjustable from 1 to 48 in the Clusters screen). A project enters at the top once, then keeps its place until you drag it elsewhere, and drops out once that time passes without use — use being your last message to one of its sessions. A project on the list keeps all of its sessions.
• Hide from Recents. Hover a project in Recents and press the crossed-out eye next to "+" and "⋯" to drop it from the list until it is used again.
• All. The full list, exactly as Paseo shows it.
• Status rings. Dashed while a workspace in the cluster is running, green when one has finished and you have not opened it yet.
• Drag and drop. Drag a project onto a circle to move it into that cluster, or up and down to order it inside the cluster. The circles reorder by dragging too.
• Management screen. Create clusters with a name, an icon (letter, emoji or symbol) and any hex color; move projects between clusters; search; and an All tab listing unassigned projects.
• One project, one cluster. New projects join whichever cluster is selected.
• One bar for all your daemons. With several daemons connected, the bar and the Clusters screen show the clusters of all of them, each on its own: two nodes with a "Personal" each show two, and the Clusters screen names the node of each. A cluster is stored on the node it was created on and can hold projects of any node. Renaming or deleting a cluster changes that one only. The selected circle stays per client.
• Recents spans your daemons. The sidebar lists projects from every connected daemon, and so does Recents. Each project keeps its place on the daemon that owns it, so nothing of yours is written anywhere else. The time window is one for the whole bar: the one set on the daemon the bar is anchored to.
• English and Spanish, following the client's language.

Limitations

• Paseo 0.8.0 or newer.
• Desktop only. The circles are injected into the app's web UI, so they do not appear on iOS or Android. On mobile the Clusters screen still lists your clusters and their workspaces.
• The plugin relies on the data-testid attributes of Paseo's sidebar. They are stable, but a Paseo update may change them; open an issue if something stops showing up.

Development

npm install
npm run typecheck
npm test
paseo plugin install /path/to/paseo-plugin-clusters
paseo plugin reload paseo-clusters   # after every change
paseo plugin logs paseo-clusters

License

MIT