All plugins
by thisjrodriguez
paseo-clusters
by thisjrodriguezClusters de proyectos para la barra lateral de Paseo
v0.1.1 Requires Paseo >=0.8.0
Gallery
Community-submitted — not owned or vetted by paseo.cafe
This listing is generated automatically from the plugin's own public repository. We don't audit, endorse, or take responsibility for third-party plugin code. Paseo plugins are trusted, unsandboxed code with filesystem, process, and network access on the machine they run on — read the source at thisjrodriguez/paseo-plugin-clusters before installing.
Caveats
- The sidebar circles only appear in the desktop app; iOS and Android get the Clusters screen instead.
- It hooks into Paseo's sidebar through its data-testid attributes, so a Paseo UI update may break it.
- Clusters are stored per daemon and shared by every client connected to that daemon.
From the plugin's README
- 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-testidattributes of Paseo's sidebar. They are stable, but a Paseo update may change them; open an issue if something stops showing up.
Install
npmjs · Paseo 0.9+
paseo plugin add npm:@thisjrodriguez/paseo-plugin-clusters@0.1.1GitHub · Paseo 0.8 fallback
paseo plugin add thisjrodriguez/paseo-plugin-clusters --ref 5fe512c4cfa01aa0c4d7a4441847e5eff0e0c610Git security status and fallback installation are pinned to commit 5fe512c4cfa0.
From the plugin's README
paseo plugin install github:thisjrodriguez/paseo-plugin-clusters
README
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 in the last 24 hours. A project enters at the top once, then keeps its place until you drag it elsewhere, and drops out after 24 idle hours.
- 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.
- Synced. Clusters live on the daemon, so every client connected to that machine shares them. The selected circle stays per client.
- English and Spanish, following the client's language, with a picker in the cluster form.
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-testidattributes 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
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, drag handling and state |
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
Scanned 21 Sep 2026, 09:31 UTC from thisjrodriguez/paseo-plugin-clusters.