Skip to content

About

No description, website, or topics provided.

Resources

Stars

12 stars

Watchers

0 watching

Forks

Repository files navigation

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

Cluster circles above the Paseo workspace list

What it does

  • Circles in the sidebar. A row above "New workspace". Selecting a cluster filters the native list down to its projects. The row is anchored to the "New workspace" button, so it only shows while that button is visible in the sidebar; if you hid it, turn it back on to see the circles.
  • 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.
  • The circles need the "New workspace" button in the sidebar. With it hidden, the bar does not appear.

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
File Purpose
index.client.tsx Registers the screen and menu, starts the bar and the sync
client/web.ts Circle bar, native list filtering and drag handling
client/store.ts Cluster state, one copy per connected daemon
client/clusters.tsx Cluster management screen
client/cluster-form.tsx Create and edit form
index.server.ts, server/storage.ts Stores clusters on the daemon
shared/i18n.ts English and Spanish strings

License

MIT

About

No description, website, or topics provided.

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages